> 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/basic-properties-property-subgroup-1.2.2.1.nn.md). # Basic Properties - Property Subgroup 1.2.2.1.nn ## Table PS-1 - SSID - Property 1.2.2.1.1.1


Property Description
Property OID	1.2.2.1.1.1 / 0x010202010101
Name	SSID
Description	The device uses this property to set SSID for WLAN settings. If the SSID is shorter than 32 bytes, all remaining bytes after the SSID should be set to zeros.
Securing Key	None
Min. Len (b)	32
Max. Len (b)	32
Data Type	Binary
Valid Values
Default	None

## Table PS-2 - SSID - Get Request Example


Example (Hex)
AA00 81040122D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C100

## Table PS-3 - SSID - Get Response Example

Example (Hex)

AA00 81048222D101 820400000000 8482003AD101 81072B06010401F609 850101 892AE228E226E124E122C1204D7953534944000000000000000000000000000000000000000000000

0000000

## Table PS-4 - SSID - Set Request Example


Example (Hex)
AA00 81040121D111 843AD111 81072B06010401F609 850101 892AE228E226E124E122C120 4D79535349440000000000000000000000000000000000000000000000000000

## Table PS-5 - SSID - Set Response Example

Example (Hex)

AA00 81048221D111 820400000000 8482003AD111 81072B06010401F609 850101 892AE228E226E124E122C1204D7953534944000000000000000000000000000000000000000000000

0000000

## Table PS-6 - Password - Property 1.2.2.1.1.2


Property Description
Property OID	1.2.2.1.1.2 / 0x010202010102
Name	Password
Description	The device uses this property to set password for WLAN settings. If the password is shorter than 63 bytes, all remaining bytes after the password should be set to zeros. For EAP-PEAP authentication, the maximum length of password is 32 bytes. The real password has to be <= 32 bytes, all bytes after the desired password must be set to zeroes. For security, the Get request for this property will always return a value with 63 zeroes, so you can only set the password and not get it.
Securing Key	None
Min. Len (b)	63
Max. Len (b)	63
Data Type	Binary
Valid Values
Default	None

## Table PS-7 - Password - Get Request Example


Example (Hex)
AA00 81040110D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C200

## Table PS-8 - Password - Get Response Example


Example (Hex)
AA00 8104820CD101 820400000000 84820059D101 81072B06010401F609 850101 8949E247E245E143E141C23F00000000

## Table PS-9 - Password - Set Request Example


Example (Hex)
AA00 81040112D111 8459D111 81072B06010401F609 850101 8949E247E245E143E141C23F546F744031386342

## Table PS-10 - Password - Set Response Example


Example (Hex)
AA00 81048212D111 820400000000 84820059D111 81072B06010401F609 850101 8949E247E245E143E141C23F546F744031386342

## Table PS-11 - Security Mode - Property 1.2.2.1.1.3


Property Description
Property OID	1.2.2.1.1.3 / 0x010202010103
Name	Security Mode
Description	The device uses this property to determine the authentication method to be used to connect to an WiFi Access Point.
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 = PSK (Personal) Mode, requires Property 1.2.2.1.1.2 Password 0x01 = EAP-PEAP (Enterprise) Mode, requires Property 1.2.2.1.1.2 Password, Property 1.2.2.1.1.C Username
Default	None

## Table PS-12 - Security Mode - Get Request Example


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

## Table PS-13 - Security Mode - Get Response Example


Example (Hex)
AA00 81048203D101 820400000000 8482001BD101 81072B06010401F609 850101 890BE209E207E105E103C30100

## Table PS-14 - Security Mode - Set Request Example


Example (Hex)
AA00 81040104D111 841BD111 81072B06010401F609 850101 890BE209E207E105E103C30101

## Table PS-15 - Security Mode - Set Response Example


Example (Hex)
AA00 81048204D111 820400000000 8482001BD111 81072B06010401F609 850101 890BE209E207E105E103C30101

## Table PS-16 - Static IP Address - Property 1.2.2.1.1.4


Property Description
Property OID	1.2.2.1.1.4 / 0x010202010104
Name	Static_IP_Address
Description	The device uses this property as its IP address in web socket mode if Property 1.2.2.1.1.5 Use DHCP is set to 0000 (Static IP mode).
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	None

## Table PS-17 - Static IP Address - Get Request Example


Example (Hex)
AA00 81040105D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C400

## Table PS-18 - Static IP Address - Get Response Example


Example (Hex)
AA00 81048205D101 820400000000 8482001ED101 81072B06010401F609 850101 890EE20CE20AE108E106C404C0A80177

## Table PS-19 - Static IP Address - Set Request Example


Example (Hex)
AA00 81040111D111 841ED111 81072B06010401F609 850101 890EE20CE20AE108E106C404C0A8016D

## Table PS-20 - Static IP Address - Set Response Example


Example (Hex)
AA00 81048211D111 820400000000 8482001ED111 81072B06010401F609 850101 890EE20CE20AE108E106C404C0A8016D

## Table PS-21 - Use DHCP - Property 1.2.2.1.1.5


Property Description
Property OID	1.2.2.1.1.5 / 0x010202010105
Name	Use_DHCP
Description	The device uses this property to determine if it gets its IP from a DHCP server or uses a static IP. 0000—use static IP address; othervalue—get IP address from DHCP server
Securing Key	None
Min. Len (b)	4
Max. Len (b)	4
Data Type	Binary
Valid Values	0000 to FFFF
Default	0001

## Table PS-22 - Use DHCP - Get Request Example


Example (Hex)
AA00 81040117D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C500

## Table PS-23 - Use DHCP - Get Response Example


Example (Hex)
AA00 81048217D101 820400000000 8482001ED101 81072B06010401F609 850101 890EE20CE20AE108E106C50400000001

## Table PS-24 - Use DHCP - Set Request Example


Example (Hex)
AA00 81040116D111 841ED111 81072B06010401F609 850101 890EE20CE20AE108E106C50400000001

## Table PS-25 - Use DHCP - Set Response Example


Example (Hex)
AA00 81048216D111 820400000000 8482001ED111 81072B06010401F609 850101 890EE20CE20AE108E106C50400000001

## Table PS-26 - Static IP Netmask - Property 1.2.2.1.1.6


Property Description
Property OID	1.2.2.1.1.6 / 0x010202010106
Name	Static_IP_Netmask
Description	The device uses this property as its network mask in web socket mode.
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.255
Default	None

## Table PS-27 - Static IP Netmask - Get Request Example


Example (Hex)
AA00 81040118D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C600

## Table PS-28 - Static IP Netmask - Get Response Example


Example (Hex)
AA00 81048218D101 820400000000 8482001ED101 81072B06010401F609 850101 890EE20CE20AE108E106C604FFFFFF00

## Table PS-29 - Static IP Netmask - Set Request Example


Example (Hex)
AA00 81040119D111 841ED111 81072B06010401F609 850101 890EE20CE20AE108E106C604FFFFFF00

## Table PS-30 - Static IP Netmask - Set Response Example


Example (Hex)
AA00 81048219D111 820400000000 8482001ED111 81072B06010401F609 850101 890EE20CE20AE108E106C604FFFFFF00

## Table PS-31 - Static IP Gateway - Property 1.2.2.1.1.7


Property Description
Property OID	1.2.2.1.1.7 / 0x010202010107
Name	Static_IP_Gateway
Description	The device uses this property as its network gateway 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.255
Default	None

## Table PS-32 - Static IP Gateway - Get Request Example


Example (Hex)
AA00 8104011AD101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C700

## Table PS-33 - Static IP Gateway - Get Response Example


Example (Hex)
AA00 8104821BD101 820400000000 8482001ED101 81072B06010401F609 850101 890EE20CE20AE108E106C704C0A801FE

## Table PS-34 - Static IP Gateway - Set Request Example


Example (Hex)
AA00 8104011CD111 841ED111 81072B06010401F609 850101 890EE20CE20AE108E106C704C0A801FE

## Table PS-35 - Static IP Gateway - Set Response Example


Example (Hex)
AA00 8104821CD111 820400000000 8482001ED111 81072B06010401F609 850101 890EE20CE20AE108E106C704C0A801FE

## Table PS-36 - Device Name - Property 1.2.2.1.1.8


Property Description
Property OID	1.2.2.1.1.8 / 0x010202010108
Name	Device Name
Description	The device uses this property to set Device Name for WLAN settings. Device Name is registered to the DNS which adds the domain name to create a hostname. Use Hostname to connect to device WebSocket. If the Device Name is shorter than 64 bytes, all remaining bytes after the Device Name should be set to zeros.
Securing Key	None
Min. Len (b)	64
Max. Len (b)	64
Data Type	Binary
Valid Values
Default	None

## Table PS-37 - Device Name - Get Request Example


Example (Hex)
AA00 81040128D101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C800

## Table PS-38 - Device Name - Get Response Example

Example (Hex)

AA00 81048228D101 820400000000 8482005AD101 81072B06010401F609 850101 894AE248E246E144E142C84064662D787878787878780000000000000000000000000000000000000

00000000000000000000000000000000000000000000000000000000000000000000000

## Table PS-39 - Device Name - Set Request Example

Example (Hex)

AA00 81040127D111 845AD111 81072B06010401F609 850101 894AE248E246E144E142C840 64662D78787878787878000000000000000000000000000000000000000000000000000000000000000

000000000000000000000000000000000000000000000

## Table PS-40 - Device Name - Set Response Example

Example (Hex)

AA00 81048227D111 820400000000 8482005AD111 81072B06010401F609 850101 894AE248E246E144E142C84064662D787878787878780000000000000000000000000000000000000

00000000000000000000000000000000000000000000000000000000000000000000000

## Table PS-41 - Wireless Heartbeat Time - Property 1.2.2.1.1.9

Property Description
Property OID	1.2.2.1.1.9 / 0x010202010109
Name
Property Description	Wireless Heartbeat Time
Description	The device uses this property to set Heartbeat Time for WLAN settings. Device will check the Websocket connection based on this timer setting. The unit is second.
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x00 to 0xFF
Default	0x00 (disabled)

## Table PS-42 - Wireless Heartbeat Time - Get Request Example


Example (Hex)
AA00 8104011AD101 841AD101 81072B06010401F609 850101 890AE208E206E104E102C900

## Table PS-43 - Wireless Heartbeat Time - Get Response Example


Example (Hex)
AA00 8104821AD101 820400000000 8482001BD101 81072B06010401F609 850101 890BE209E207E105E103C90100

## Table PS-44 - Wireless Heartbeat Time - Set Request Example


Example (Hex)
AA00 8104011CD111 841BD111 81072B06010401F609 850101 890BE209E207E105E103C90120

## Table PS-45 - Wireless Heartbeat Time - Set Response Example


Example (Hex)
AA00 8104821CD111 820400000000 8482001BD111 81072B06010401F609 850101 890BE209E207E105E103C90120

## Table PS-46 - Maximum Client Connections - Property 1.2.2.1.1.A


Property Description
Property OID	1.2.2.1.1.A / 0x01020201010A
Name	Maximum Client Connections
Description	The device uses this property to determine how many clients it will allow to connect to its WLAN WebSocket server at one time. Most use cases will only want to allow one client at a time. If more than one client is connected, all outgoing data from the device will be sent to all clients. For example, all notifications and all command responses will be sent to all clients. If more than one client is connected, any client can send a command to the device at any time. Since having more than one client send commands to the device at the same time can result in command collisions and unexpected device behavior, it is recommended that only one client be in charge of sending commands and that other clients only listen to outgoing messages. A use case for allowing more than once client may be to have a second client for diagnostic or monitoring purposes. Property 2.1.2.5.6.4 Active Client Connections is related.
Securing Key	None
Min. Len (b)	1
Max. Len (b)	1
Data Type	Binary
Valid Values	0x01 – 0x04
Default	0x01

## Table PS-47 - Maximum Client Connections - Get Request Example


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

## Table PS-48 - Maximum Client Connections - Get Response Example


Example (Hex)
AA0081048255D10182040000000084820010D1018501018704020201018903CA0101

## Table PS-49 - Maximum Client Connections - Set Request Example


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

## Table PS-50 - Maximum Client Connections - Set Response Example


Example (Hex)
AA0081048255D11182040000000084820010D1118501018704020201018903CA0101

--- # 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/basic-properties-property-subgroup-1.2.2.1.nn.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.