> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/wlan-settings-wlan-only-property-subgroup-1.2.2.1.nn-a.md). # WLAN Settings (WLAN Only) - Property Subgroup 1.2.2.1.nn - A ## Table WSWA - 1 - Certificate Expiring Soon Notification Threshold - Property 1.2.2.1.1.B


Property Description
Property OID	1.2.2.1.1.B / 0x01020201010B
Name	Certificate Expiring Soon Notification Threshold
Description	The device uses this property to determine how many days before a certificate expires it should start notifying the host that it is about to expire. If the value is set to 0, the notification will be disabled. The notification will only be sent if TLS is enabled, and the notification will only be sent for they server certificate that the device is configured to use. The notification will be sent every time the first client connects to the device shortly after it connects. Notification 0x1001 - Device Information Update category Key management, reason Certificate Expiring Soon is related.
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 – 0xFF
Default	0x1E (30 days)

## Table WSWA-2 - Certificate Expiring Soon Notification Threshold - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 8501 01 8704 02020101 8902 CB00

## Table WSWA-3 - Certificate Expiring Soon Notification Threshold - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020201018903CB011E

## Table WSWA-4 - Certificate Expiring Soon Notification Threshold - Set Request Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 8704 02020101 8903 CB011E

## Table WSWA-5 - Certificate Expiring Soon Notification Threshold - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020201018903CB011E

## Table WSWA-6 - Username - Property 1.2.2.1.1.C


Property Description
Name	Username
Property OID	1.2.2.1.1.C / 0x01020201010C
Description	The device uses this property to set up the Username for EAP-PEAP authentication method which is used to connect to an WiFi Access Point. Username is not used by PSK authentication method.
Securing Key	None
Min. Len (b)	N/A
Max. Len (b)	32
Data Type	ASCII String
Valid Values	Example: joe@MagTek.com
Default	None

## Table WSWA-7 - Username - Get Request Example


Example (Hex)
AA00 8104010DD101 841AD101 81072B06010401F609 850101 890AE208E206E104E102CC00

## Table WSWA-8 - Username - Get Response Example

Example (Hex)

AA00 8104820DD101 820400000000 8482003AD101 81072B06010401F609 850101 892AE228E226E124E122CC 206A6F65406D616774656B2E636F6D00000000000000

0000000000000000000000

## Table WSWA-9 - Username - Set Request Example


Example (Hex)
AA00 8104010ED111 843AD111 81072B06010401F609 850101 892AE228E226E124E122CC 206A6F65406D616774656B2E636F6D000000000000000000

## Table WSWA-10 - Username - Set Response Example

Example (Hex)

AA00 8104820ED111 820400000000 8482003AD111 81072B06010401F609 850101 892AE228E226E124E122CC 206A6F65406D616774656B2E636F6D

000000000000000000000000000000000000

## Table WSWA-11 - SoftAP IP Address - Property 1.2.2.1.1.D


Property Description
Property OID	1.2.2.1.1.D / 0x01020201010D
Name	SoftAP_IP_Address
Description	This OID is used to store a soft AP IP address. When a device starts AP mode, it reads this value as its IP address. A new value will be stored with this OID if a user modifies the soft AP IP address.
Securing Key	None
Min. Len (b)	4
Max. Len (b)	4
Data Type	IP4 Format/quad decimal (x.x.x.x)
Valid Values	0.0.0.0 to 255.255.255
Default	192.168.0.1

## Table WSWA-12 - SoftAP IP Address - Get Request Example


Example (Hex)
AA00 81040103D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102CD00

## Table WSWA-13 - SoftAP IP Address - Get Response Example


Example (Hex)
AA00 81048203D101 820400000000 8482001ED101 81072B06010401F609 850101 890EE20CE20AE108E106CD0400000000

## Table WSWA-14 - SoftAP IP Address - Set Request Example


Example (Hex)
AA00 81040107D111 841ED111 81072B06010401F609 850101 890EE20CE20AE108E106CD04C0A80177

## Table WSWA-15 - SoftAP IP Address - Set Response Example


Example (Hex)
AA00 81048207D111 820400000000 8482001ED111 81072B06010401F609 850101 890EE20CE20AE108E106CD04C0A80177

## Table WSWA-16 - WLAN Protocol - Property 1.2.2.1.2.11


Property Description
Property OID	1.2.2.1.1.11 / 0x010202010111
Name	WLAN Protocol
Description	The device uses this property to set the WLAN Protocol. 0x00 = MQTT 0x01 = RFU 0x02 = WebSocket Server
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 – 0x02
Default	0x02

## Table WSWA-17 - WLAN Protocol - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 850101 870402020101 8902 D100

## Table WSWA-18 - WLAN Protocol - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020201018903D10102

## Table WSWA-19 - WLAN Protocol - Set Request Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 870402020101 8903 D101 02

## Table WSWA-20 - WLAN Protocol - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020201018903D10102

## Table WSWA-21 - WLAN Disable - Property 1.2.2.1.1.12


Property Description
Property OID	1.2.2.1.1.12 / 0x010202010112
Name	WLAN Disable
Description	The device uses this property to disable/enable WLAN Feature. 0x00 = WLAN Disabled 0x01 = WLAN Enabled Changes to this property do not take effect until the device is power cycled or reset.
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 – 0x01
Default	0x01

## Table WSWA-22 - WLAN Disable - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 850101 870402020101 8902 D200

## Table WSWA-23 - WLAN Disable - Get Response Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 8704 02020101 8903 D20101

## Table WSWA-24 - WLAN Disable - Set Request Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 8704 02020101 8903 D20100

## Table WSWA-25 - WLAN Disable - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020201018903D20100

## Table WSWA-26 - MQTT Broker Address - Property 1.2.2.1.2.1


Property Description
Property OID	1.2.2.1.2.1 / 0x010202010201
Name	MQTT Broker Address
Description	The device uses this property to connect to broker on network. Address can be an URL or IP address.
Securing Key	None
Min. Len (b)	N/A
Max. Len (b)	64
Data Type	ASCII String with no spaces
Valid Values	Any string Example: test.mosquitto.org
Default	test.mosquitto.org

## Table WSWA-27 - MQTT Broker Address - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 850101 8704 02020102 8902 C100

## Table WSWA-28 - MQTT Broker Address - Get Response Example

Example (Hex)

AA0081048255D1018204000000008482004FD1018501018704020201028942C140 746573742E6D6F7371756974746F2E6F72670000000000000000000000000000000000000000000000

0000000000000000000000000000000000000000000000

## Table WSWA-29 - MQTT Broker Address - Set Request Example

Example (Hex)

AA00 81040155D111 844F D111 850101 870402020102 8942 C140

746573742E6D6F7371756974746F2E6F 72670000000000000000000000000000

00000000000000000000000000000000 00000000000000000000000000000000

## Table WSWA-30 - MQTT Broker Address - Set Response Example

Example (Hex)

AA0081048255D1118204000000008482004FD1118501018704020201028942C140 746573742E6D6F7371756974746F2E6F72670000000000000000000000000000000000000000000000

0000000000000000000000000000000000000000000000

## Table WSWA-40 - MQTT Port - Property 1.2.2.1.2.2


Property Description
Property OID	1.2.2.1.2.2 / 0x010202010202
Name	MQTT Port
Description	The device uses this property to connect to broker on this network port. MQTT Port addresses are normally 8883 for secure (Recommended), 1883 for unsecure.
Securing Key	None
Min. Len (b)	2
Max. Len (b)	2
Data Type	Binary
Valid Values	0x00 0x00 (0) – 0xFF 0xFF (65535) MSB first
Default	8883

## Table WSWA-41 - MQTT Port - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 850101 870402020102 8902 C200

## Table WSWA-42 - MQTT Port - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820011D1018501018704020201028904C20222B3

## Table WSWA-43 - MQTT Port - Set Request Example


Example (Hex)
AA00 81040155D111 8411 D111 850101 870402020102 8904 C202 22B3

## Table WSWA-44 - MQTT Port - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820011D1118501018704020201028904C202 22B3

## Table WSWA-45 - MQTT QoS Quality of Service - Property 1.2.2.1.2.3

Property Description
Property OID	1.2.2.1.2.3 / 0x010202010203
Name	MQTT QoS
Description	The device uses this property to set the MQTT QoS. 0x00 = At most once (Recomnended) 0x01 = At least once 0x02 = Exactly once
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 – 0x02
Default	0x00

## Table WSWA-46 - MQTT QoS Quality of Service - Get Request Example


Example (Hex)
AA00 8104 0155D101 840F D101 850101 870402020102 8902 C300

## Table WSWA-47 - MQTT QoS Quality of Service - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020201028903C301 00

## Table WSWA-48 - MQTT QoS Quality of Service - Set Request Example


Example (Hex)
AA00 81040155D111 8410 D111 850101 870402020102 8903C301 00

## Table WSWA-49 - MQTT QoS Quality of Service - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020201028903C30100

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/configuration/device-settings-property-group-1.2.nnnn/wlan-settings-wlan-only-property-subgroup-1.2.2.1.nn-a.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.