Command Manual-[EN]

W232N AT Command Overview

W232N provides various commands for the product’s setting and control. Each command is composed of a 2 byte alphabet character strings and all capital letters. By using these commands users can add script to the serial device or main MCU for product settings, and also can create a program for controlling the W232N module via network.

Each command can operate read/write depending on the parameter, and there is also a read only command.

Entering the command and switching the command mode of the serial port device is done using the data UART port. The debug UART port is not supported for command entering or operation.

Identical 2-byte character strings is used for setting the product with commands via serial and Ethernet network, but there will a distinction of the sending frame form. Thus this document will cover explanations of all commands and guides for each sending methods and its form of frames.

The different command modes are as following.

Control Device Using Serial Command Mode
Control Device Using Ethernet Network

The Configuration tool provided by WIZnet uses the identical command set to control W232N.
For example, when the MC command for checking the MAC address and the VR command for checking the firmware are identical.

Abbreviations

Abbreviation	Description
CR	Carriage Return, moves the cursor to the far left(starting) position ('\r', 0x0D)
LF	Line Feed, moves the cursor to the new line below ('\n', 0x0A)
N	Number of commands
RW	Read / Write
RO	Read only
WO	Write only

Usage of Command Set

Control Device Using Serial Command Mode

You can use either of the two methods below to enter serial command mode.

1. Enter command mode using hardware trigger pin

Use the HW_TRIG pin of the W232N (For the EVB, HW_TRIG switch) to enter command mode.
Upon turning the power on, check the pin to enter command mode. Use the trigger pin to re-enter the command mode when rebooting.
The trigger pin should be pull-up, and operates as low active.
This method is used when users wish to change settings while the product operation is initiated.

  - Set the hardware trigger pin(HW_TRIG) to Low.
    · When using the EVB, place the HW_TRIG switch to Command.

  - Power on the W232N.
    · When operating in serial command mode, users can check the following message via Debug UART port.
    · <code>> SEG:AT Mode </code>

  - Enter the Command and Parameter that needs setting via serial port((Data UART port)).

  - Switch to data transmission mode(GW mode) using [[#ex|EX]] command.
    · If the switch to data transmission mode is successful, users can check the following message via Debug UART port.
    · <code>> SEG:GW Mode </code>

2. Enter command mode using command mode switch code

Users can enter command mode using the command mode switch code provided by W232N.
The command mode switch codes can be used only if it is enabled in the configuration tool. (default: Enabled)
The command mode switch code is composed of 3-byte Hex codes, and can be changed to a different value if needed. The code only accepts Hex value. (default: Hex [2B][2B][2B])

  - Check if 'Serial command mode switch code' is enabled at the configuration tool and the 3-bytes 'command mode switch code'.

  - Enter the ‘command mode switch code’ via data UART port to change modes.
    · Read below what you need to be cautious about when switching to command mode.
    · When operating in serial command mode, users can check the following message via Debug UART port.
    · <code>> SEG:AT Mode </code>

  - Enter the Command and Parameter that needs setting via serial port.

  - Use [[#ex|EX]] command to switch to data transmission mode.
    · When operating in data transmission mode, users can check the following message via Debug UART port.
    · <code>> SEG:GW Mode </code>

Command mode switch trigger code via Data UART port
Char '+++'

Please be cautious when using the trigger code to switch command mode.

  - There has to be a time gap of **at least 500ms** at the start and end of the ‘command mode switch code’ in order it to be read as switch code.

  - The entering time in between each byte of the ‘3-byte command mode switch code’ has to be **below 500ms**.

  - Do not add CR or LF at the end of the command mode switch code((Conversely, the serial command after mode switch must end with CR or LF.)).

  - The default values of 1 and 2 above are **500ms**; these values change to the timer value if the timer value of the serial data packing option is set to a certain value.

Serial Command Frame Format

You must include CR and LF at the end of each command. CR and LF must be included at the end of each commands when multiple commands are entered simultaneously.

Get Request

[2-bytes Command Code] [CR] [LF]

Enter command without parameter.
The response relevant to the command will return.

Set Request

[2-bytes Command Code] [Parameters] [CR] [LF]

Enter the command and parameters you wish to set.
There will be no particular response and the field value relevant to the command will change instantly.
You have to use the SV command in order to save settings, and use the RT command to change IP allocation methods or other initial operation changes.

* Note: You can check the Echoback of UART command via EC command.

Control Device Using Ethernet Network

Users can control or monitor W232N via Ethernet by using the following commands. The user must use UDP or TCP client to send commands, and the port number for processing the commands is 50001.

Network information for command transmission: UDP / TCP Server : 50001 (User can send the commands by UDP / TCP Client to device)

Ethernet Command Frame Format

Two additional commands are required before sending the command code when controlling the W232N via Ethernet. All other settings and operations are the same as when sending the serial command code via data UART port.

The two additional commands are MA and PW.

[MA] command
- This field shows the product’s MAC address.
- In both cases of TCP and UDP, 6-byte MAC address must be included after the 2-byte MA command.
  - When users wish to broadcast only Get Request via UDP, the relevant field value can be set as the Broadcast MAC address. Users can receive responses from multiple peers. The search function of the configuration tool is implemented like this
[PW] command

Users must use UDP or TCP client because the UDP or TCP server is operating to handle the device commands.
Data is sent to the broadcast IP address 255.255.255.255, and data can be sent to all peers in the same network.
FF:FF:FF:FF:FF:FF
Hex 0x20 is ASCII code, which means blank.

Get Request

When sending a single command

MA [MAC] [CR] [LF] PW [Search ID] [CR] [LF] [Command] [CR] [LF]

When sending multiple commands

MA [MAC] [CR] [LF] PW [Search ID] [CR] [LF] ([Command] [CR] [LF]) * Number of commands

The response for ‘get request’ will have the identical format as ‘request’ but include the parameter.

Set Request

When sending a single command

MA [MAC] [CR] [LF] PW [Search ID] [CR] [LF] [Command] [Parameters] [CR] [LF]

When sending multiple commands

MA [MAC] [CR] [LF] PW [Search ID] [CR] [LF] ([Command] [Parameters] [CR] [LF]) * Number of commands

For ‘Set Request’, there is no additional response needed for changing the product setting.
If users want to check the modified setting, send the command without parameter at the end of the ‘Set Request frame’; in form of Set + Get Request.

Ethernet Command Examples

Example #1: UDP Get Command Frame

When requesting MAC and local IP from multiple devices via UDP
- Search ID is not used

Request from User

Command Frame

MA [FF FF FF FF FF FF] [CR] [LF] PW [ ] [CR] [LF] MC [CR] [LF] LI [CR] [LF]

Hex code version of Command Frame

4D 41 FF FF FF FF FF FF 0D 0A 50 57 20 0D 0A 4D 43 0D 0A 4C 49 0D 0A

Response by W232N

The response for ‘Get Request’ has the same form as ‘Set Request’.

Command Frame

MA [00 08 DC 00 00 11] [CR] [LF] PW [ ] [CR] [LF] MC [00 08 DC 00 00 11] [CR] [LF] LI [192.168.11.2] [CR] [LF]

Hex code version of Command Frame

4D 41 00 08 DC 00 00 11 0D 0A 50 57 20 0D 0A 4D 43 00 08 DC 00 00 11 0D 0A 4C 49 31 39 32 2E 31 36 38 2E 31 31 2E 32 0D 0A

Example #2: TCP Get Command Frame

When requesting the local IP of the device, which MAC address is 00:08:DC:00:00:11, via TCP
- Search ID is not used

Request from User

Command Frame

MA [00 08 DC 00 00 11] [CR] [LF] PW [ ] [CR] [LF] LI [CR] [LF]

Hex code version of Command Frame

4D 41 00 08 DC 00 00 11 0D 0A 50 57 20 0D 0A 4C 49 0D 0A

Response by W232N

Command Frame

MA [00 08 DC 00 00 11] [CR] [LF] PW [ ] [CR] [LF] LI [192.168.11.2] [CR] [LF]

Hex code version of Command Frame

4D 41 00 08 DC 00 00 11 0D 0A 50 57 20 0D 0A 4C 49 31 39 32 2E 31 36 38 2E 31 31 2E 32 0D 0A

Example #3: TCP Set Command Frame

When requesting the local IP of the device, which MAC address is 00:08:DC:00:00:11, via TCP
- If the Search ID is set to HELLO
- Or if user wishes to change the local IP to 192.168.11.5

Request from User

Command Frame

MA [00 08 DC 00 00 11] [CR] [LF] PW [HELLO] [CR] [LF] LI [192.168.11.5] [CR] [LF]

Hex code version of Command Frame

4D 41 00 08 DC 00 00 11 0D 0A 50 57 48 45 4C 4C 4F 0D 0A 4C 49 31 39 32 2E 31 36 38 2E 31 31 2E 35 0D 0A

Response by W232N

None

When modifying the IP address format, '.'(dot, 0x2E) must be included such as the '192.168.11.5'.

Command list

The Set command setting the applicable value will operate if the parameter is included when entering the command.
The Get command reading the applicable value will operate if only the command is entered.
If the ‘Read only’ sign does not appear, it means the command supports both Get / Set.
Write only command is for controlling the product without the parameter.
There is a basic command list and an expanded command list.
Settings like IP allocation settings or DNS operation settings via command mode require ‘module reboot’ via RT command after the settings are saved via SV command.

IPv4 address forms like IP address, Gateway address, subnet mask, DNS server address, or Remote IP address.
Save setting, reboot, switch mode, factory reset and Etc.
WIZ107SR / WIZ108SR sync command list, excluding [UN], [UI] command
WIZ750SR / WIZ750SR-1xx / WIZ750SR-12x sync command list, including [UN], [UI] command
WIZ510SSL sync command list, including [UN], [UI] command
W232N exclusive command list
When the remote peer address is changed from IP address to domain

Basic Commands

Command	Category	Description	Type
MC	Device Information	MAC address	RO
VR	:::	Firmware version	RO
MN	:::	Product name	RO
ST	:::	Operation status	RO
UN	:::	UART interface(str)	RO
UI	:::	UART interface(code)	RO
OP	Network Settings	Network operation mode	RW
IM	:::	IP address allocation method (static/DHCP)	RW
LI	:::	Local IP address	RW
SM	:::	Subnet mask	RW
GW	:::	Gateway address	RW
DS	:::	DNS server address	RW
LP	:::	Local port number	RW
RH	:::	Remote host IP address / Domain	RW
RP	:::	Remote host port number	RW
BR	Data UART Settings	UART Baud rate	RW
DB	:::	UART Data bit	RW
PR	:::	UART Parity bit	RW
SB	:::	UART Stop bit	RW
FL	:::	UART Flow control	RW
EC	:::	UART Echoback enable	RW
PT	Serial Data Packing Options	Time delimiter	RW
PS	:::	Size delimiter	RW
PD	:::	Char delimiter	RW
IT	Options	Inactivity timer value	RW
RI	:::	TCP Reconnection interval (TCP client only)	RW
CP	:::	Connection password enable (TCP server only)	RW
NP	:::	Connection password (TCP server only)	RW
SP	:::	Search ID code	RW
DG	:::	Serial debug message enable	RW
KA	:::	TCP Keep-alive enable	RW
KI	:::	TCP Keep-alive initial interval	RW
KE	:::	TCP Keep-alive retry interval	RW
SO	:::	SSL receive timeout	RW
QU	MQTT Settings	MQTT user name	RW
QP	:::	MQTT password	RW
QC	:::	MQTT client ID	RW
QK	:::	MQTT Keep-alive	RW
PU	:::	MQTT publish topic	RW
U0	:::	MQTT subscribe topic 1	RW
U1	:::	MQTT subscribe topic 2	RW
U2	:::	MQTT subscribe topic 3	RW
QO	:::	MQTT QoS level	RW
RC	Certificate Settings	Root CA verify option	RW
CE	:::	Client certificate enable	RW
OC	:::	Root CA	WO
LC	:::	Client certificate	WO
PK	:::	Private key	WO
TE	Command Mode Switch Settings	Command mode switch code enable	RW
SS	:::	Command mode switch code (3-bytes Hex)	RW
EX	Device Control	Command mode exit (switch to data transfer mode)	WO
SV	:::	Save device setting	WO
UF	:::	Copy firmware from firmware binary bank to application bank	RW
RT	:::	Device reboot	WO
FR	:::	Device factory reset	WO

Extended Commands

Command	Category	Description	Type
SC	Status I/O	Status pin S0 & S1 operation mode setting	RW
S0	:::	Status of pin S0 (PHY link or DTR)	RO
S1	:::	Status of pin S1 (TCP connect or DSR)	RO

Command Descriptions

Device Information

MC

Format: MC[CR][LF]
Meaning: Check product’s MAC address
Command Type: Read only
Return Type: String
Return Value:

MAC address with colons(:)
Response

Without Parameter (Get)
- In ASCII: MC00:08:DC:00:00:01\r\n

VR

Format: VR[CR][LF]
Meaning: Check the product’s firmware version
Command Type: Read only
Return Type: String
Return Value:

Firmware version with dots(.)

⇒ Major version number . Minor version number . Maintenance version number
Response

Without Parameter (Get)
- In ASCII: VR1.0.0\r\n

MN

Format: MN[CR][LF]
Meaning: Check the product name
Command Type: Read only
Return Type: String
Return Value:

Device model name

⇒ Default: WIZ5XXRSR-RP
Response

Without Parameter (Get)
- In ASCII: MNWIZ5XXRSR-RP\r\n

ST

Format: ST[CR][LF]
Meaning: Check the product operation status
Command Type: Read only
Return Type: String
Return Value:

Status	Description
BOOT	Boot mode; Users can update the product setting and firmware.
OPEN	Status before TCP connection is successful.
CONNECT	Status after TCP connection is successful.
UPGRADE	Status during firmware update or DHCP IP allocation.
ATMODE	Serial AT command mode status.

Response

Without Parameter (Get)
- In ASCII: STATMODE\r\n

UN

Format: UN[CR][LF]
Meaning: Check product’s UART Interface
Command Type: Read only
Return Type: String
Return Value:

UART interface	Description
RS-232/TTL	Device supports UART input/output of RS-232C or TTL signals.
RS-422/485	Device supports UART input/output of RS-422 and RS-485 signals.

Response

Without Parameter (Get)
- In ASCII: UNRS-232/TTL\r\n

UI

Format: UI[CR][LF]
Meaning: Check product’s UART Interface
Command Type: Read only
Return Type: String
Return Value:

Return value	Description	Remarks
0	Device supports UART input/output of RS-232 or TTL signals.	RS-232/TTL
1	Device supports UART input/output of RS-422 and RS-485 signals.	RS-422/485

Response

Without Parameter (Get)
- In ASCII: UI0\r\n

Network Settings

OP

Format: OP<Parameter>[CR][LF]
Meaning: Product’s network operation mode
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 6)
Parameter / Return Value:

Parameter / Return value	Meaning	Remarks
0	TCP client mode	-
1	TCP server mode	-
2	TCP mixed mode	TCP server / client mixed mode
3	UDP mode	-
4	SSL TCP client mode	-
5	MQTT client mode	-
6	MQTTS client mode	-

Response

Without Parameter (Get)
- In ASCII: OP0\r\n
With Parameter (Set)
- No response
- Change the network operation mode

IM

Format: IM<Parameter>[CR][LF]
Meaning: Product’s IP address allocation method
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

Parameter / Return value	Meaning	Remarks
0	Static	-
1	DHCP	Obtain an IP address automatically

Response

Without Parameter (Get)
- In ASCII: IM0\r\n
With Parameter (Set)
- No response
- Change product’s IP address allocation method

LI

Format: LI<Parameter>[CR][LF]
Meaning: Product's IP address
Command Type: Read / Write
Parameter / Return Type: String of IPv4 address form (including dot)
Parameter / Return Value:

Ex> 192.168.11.2
Response

Without Parameter (Get)
- In ASCII: LI192.168.11.2\r\n
With Parameter (Set)
- No response
- Change product’s IP address

SM

Format: SM<Parameter>[CR][LF]
Meaning: Product’s subnet mask
Command Type: Read / Write
Parameter / Return Type: String of IPv4 address form (including dot)
Parameter / Return Value:

Ex> 255.255.255.0
Response

Without Parameter (Get)
- In ASCII: SM255.255.255.0\r\n
With Parameter (Set)
- No response
- Change product’s subnet mask

GW

Format: GW<Parameter>[CR][LF]
Meaning: Product’s gateway address
Command Type: Read / Write
Parameter / Return Type: String of IPv4 address form (including dot)
Parameter / Return Value:

Ex> 192.168.11.1
Response

Without Parameter (Get)
- In ASCII: GW192.168.11.1\r\n
With Parameter (Set)
- No response
- Change product’s gateway address

DS

Format: DS<Parameter>[CR][LF]
Meaning: Product’s DNS address
Command Type: Read / Write
Parameter / Return Type: String of IPv4 address form (including dot)
Parameter / Return Value:

Ex> 8.8.8.8

Google Public DNS (IPv4)
- 8.8.8.8
- 8.8.4.4
Response

Without Parameter (Get)
- In ASCII: DS8.8.8.8\r\n
With Parameter (Set)
- No response
- Change Product’s DNS

LP

Format: LP<Parameter>[CR][LF]
Meaning: Product’s port number
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

Ex> 5000
Response

Without Parameter (Get)
- In ASCII: LP5000\r\n
With Parameter (Set)
- No response
- Change product’s port number

RH

Format: RH<Parameter>[CR][LF]
Meaning: Product’s remote host IP address / Domain name
Command Type: Read / Write
Parameter / Return Type: String of IPv4 address form (including dot) or Domain string
Parameter / Return Value:

Ex> 192.168.11.3
Response

Without Parameter (Get)
- In ASCII: RH192.168.11.3\r\n
With Parameter (Set)
- No response
- Change product’s remote host IP address

RP

Format: RP<Parameter>[CR][LF]
Meaning: Product’s remote host port number
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

Ex> 5000
Response

Without Parameter (Get)
- In ASCII: RP5000\r\n
With Parameter (Set)
- No response
- Change product’s remote host port number

Data UART Settings

BR

Format: BR<Parameter>[CR][LF]
Meaning: Baud rate of serial interface (data UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 13)
Parameter / Return Value:

Parameter / Return value	Baud rate	Remarks
0	300	-
1	600	-
2	1200	-
3	1800	-
4	2400	-
5	4800	-
6	9600	-
7	14400	-
8	19200	-
9	28800	-
10	38400	-
11	57600	-
12	115200	-
13	230400	-
14	460800	-

Response

Without Parameter (Get)
- In ASCII: BR12\r\n
With Parameter (Set)
- No response
- Change baud rate of serial interface

DB

Format: DB<Parameter>[CR][LF]
Meaning: Data bit of serial interface (data UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

Parameter / Return value	Data bit	Remarks
0	7-bit	-
1	8-bit	-

Response

Without Parameter (Get)
- In ASCII: DB1\r\n
With Parameter (Set)
- No response
- Change data bit of serial interface

PR

Format: PR<Parameter>[CR][LF]
Meaning: Parity bit of serial interface (data UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 2)
Parameter / Return Value:

Parameter / Return value	Parity bit	Remarks
0	NONE	-
1	ODD	-
2	EVEN	-

Response

Without Parameter (Get)
- In ASCII: PR0\r\n
With Parameter (Set)
- No response
- Change parity bit of serial interface

SB

Format: SB<Parameter>[CR][LF]
Meaning: Stop bit of serial interface (data UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

Parameter / Return value	Stop bit	Remarks
0	1-bit	-
1	2-bit	-

Response

Without Parameter (Get)
- In ASCII: SB0\r\n
With Parameter (Set)
- No response
- Change stop bit of serial interface

FL

Format: FL<Parameter>[CR][LF]
Meaning: Flow control of serial interface (data UART) / (RS-232/TTL interface only)
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 4)
Parameter / Return Value:

Parameter / Return value	Flow control	Remarks
0	NONE	-
1	XON/XOFF	Software flow control
2	RTS/CTS	Hardware flow control
3	RTS on TX	Hardware flow control
4	RTS on TX(invert)	Hardware flow control

Response

Without Parameter (Get)
- In ASCII: FL0\r\n
With Parameter (Set)
- No response
- Change flow control of serial interface

EC

Format: EC<Parameter>[CR][LF]
Meaning: UART Echoback function enable (data UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

0: Not used(Disabled)
1: Used(Enabled)

If this option is enabled, the received serial data becomes Echoback via serial port (data UART). This function can be used to check what the user enters via serial command mode.
Response

Without Parameter (Get)
- In ASCII: EC0\r\n
With Parameter (Set)
- No response
- Change whether UART echoback function enabled or not.

Serial Data Packing Options

PT

Format: PT<Parameter>[CR][LF]
Meaning: Data packing of serial interface (data UART) – Time delimiter
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

0: Not used
1 ~ 65535: Data packing time (unit: millisecond)
Response

Without Parameter (Get)
- In ASCII: PT0\r\n
With Parameter (Set)
- None
- Change the time delimiter value of serial data packing

PS

Format: PS<Parameter>[CR][LF]
Meaning: Data packing of serial interface (data UART) – Data size delimiter
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 255)
Parameter / Return Value:

0: Not used
1 ~ 255: Data packing size (unit: byte)
1. The received serial data is collected until the designated time is lapsed and will be sent all together via Ethernet. This time starts counting when receiving the serial data stop, and if additional serial data is received before the designated time is lapsed, the count restarts.
2. The received serial data is collected until the designated data length is reached and will be sent all together via Ethernet.
Response

Without Parameter (Get)
- In ASCII: PS0\r\n
With Parameter (Set)
- None
- Change the data size of serial data packing

PD

Format: PD<Parameter>[CR][LF]
Meaning: Data packing of serial interface (data UART) - designated character delimiter
Command Type: Read / Write
Parameter / Return Type: 1-byte Character (Hex only)
Parameter / Return Value:

00: Not used
Other: Designated character

The designated character is not included in data.
Response

Without Parameter (Get)
- In ASCII: PD00\r\n
With Parameter (Set)
- None
- Change designated character delimiter of serial data packing
The received serial data is collected until the designated character is received and will be sent all together via Ethernet.

Options

IT

Format: IT<Parameter>[CR][LF]
Meaning: Inactivity timer value for TCP connection close when there is no data exchange
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

0: Not used
1 ~ 65535: Inactivity timer value (unit: second)

If the timer is active, the TCP connection closes when there is no data exchange. The timer restarts when there is an Ethernet data exchange before reaching entered inactivity timer value.
Response

Without Parameter (Get)
- In ASCII: IT0\r\n
With Parameter (Set)
- No response
- Change inactivity timer value

CP

Format: CP<Parameter>[CR][LF]
Meaning: TCP connection password enable (TCP server mode only)
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

0: Not used(Disabled)
1: Used(Enabled)

This option is only when the product is operating as TCP server. If this option is active, the TCP client wishing to connect to the device must send first the TCP connection password and confirmation for actual data to be transmitted.
Response

Without Parameter (Get)
- In ASCII: CP0\r\n
With Parameter (Set)
- No response
- Change whether TCP connection password enabled or not.

NP

Format: NP<Parameter>[CR][LF]
Meaning: TCP connection password (TCP server mode only)
Command Type: Read / Write
Parameter / Return Type: String (up to 8-bytes)
Parameter / Return Value: Default: None(null)

This option is applicable only when product is operating as TCP server. The password can be maximum of 8 characters.
Response

Without Parameter (Get)
- In ASCII: NP\r\n
With Parameter (Set)
- No response
- Change TCP connection password

SP

Format: SP<Parameter>[CR][LF]
Meaning: Search identification code
Command Type: Read / Write
Parameter / Return Type: String (up to 8-bytes)
Parameter / Return Value: Default: None(null)

If this option is active, only the products with matching ID are found via product search by configuration tool. Search ID code can be maximum of 8 characters.
Response

Without Parameter (Get)
- In ASCII: SP\r\n
With Parameter (Set)
- No response
- Change search ID code

DG

Format: DG<Parameter>[CR][LF]
Meaning: Serial debug message enable (debug UART)
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

0: Not used(Disabled)
1: Used(Enabled)

If this option is active, the product setting or error message will output via Debug UART port.
Response

Without Parameter (Get)
- In ASCII: DG1\r\n
With Parameter (Set)
- No response
- Change whether serial debug message enabled or not.

KA

Format: KA<Parameter>[CR][LF]
Meaning: Keep-alive packet transmit enable for checking TCP connection established
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

0: Not used(Disabled)
1: Used(Enabled)

If this option is active, the keep-alive packet is sent to the TCP connection peer according to the designated interval(KI / KE). If there is no response from the peer, the TCP connection will close and the socket will initialize (socket open).
Response

Without Parameter (Get)
- In ASCII: KA1\r\n
With Parameter (Set)
- No response
- Change whether keep-alive packet transmit enabled or not.

KI

Format: KI<Parameter>[CR][LF]
Meaning: Initial TCP keep-alive packet transmission interval value
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

0: Not used
1 ~ 65535: Initial Keep-alive packet transmission interval (unit: millisecond)

The keep-alive packet is sent to the TCP connection peer according to the designated packet transmission interval. Keep-alive packet transmission becomes active only when at least one Ethernet data transmission has been made.
Response

Without Parameter (Get)
- In ASCII: KI7000\r\n
With Parameter (Set)
- No response
- Change initial keep-alive packet transmission interval value

KE

Format: KE<Parameter>[CR][LF]
Meaning: TCP Keep-alive packet transmission retry interval value
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

0: Not used
1 ~ 65535: Keep-alive packet transmission retry interval (unit: millisecond)

After the first keep-alive packet transmission is done, the next keep-alive packet is sent to the TCP connection peer according to the designated packet transmission interval. Keep-alive packet transmission becomes active only when at least one Ethernet data transmission has been made.
Response

Without Parameter (Get)
- In ASCII: KE5000\r\n
With Parameter (Set)
- No response
- Change keep-alive packet transmission retry interval value

SO

Format: SO<Parameter>[CR][LF]
Meaning: SSL receive timeout value for SSL connection close
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 60000)
Parameter / Return Value:

0: Not used
1 ~ 60000: SSL receive timeout (unit: millisecond)

If the timeout is set, the SSL connection closes when SSL receive timeout over.
Response

Without Parameter (Get)
- In ASCII: SO2000\r\n
With Parameter (Set)
- No response
- Change SSL receive timeout value

RI

Format: RI<Parameter>[CR][LF]
Meaning: TCP client reconnection interval value (TCP client only)
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

0: Not used
1 ~ 65535: TCP client reconnection interval (unit: millisecond)

If the TCP connection between the server is not successful during TCP client mode, the interval value between the next connection attempt is set.
Response

Without Parameter (Get)
- In ASCII: RI3000\r\n
With Parameter (Set)
- No response
- Change TCP client reconnection interval value

MQTT Settings

QU

Format: QU<Parameter>[CR][LF]
Meaning: MQTT user name used in the broker authentication
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: QU\r\n
With Parameter (Set)
- No response
- Change MQTT user name

QP

Format: QP<Parameter>[CR][LF]
Meaning: MQTT password used in the broker authentication
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: QU\r\n
With Parameter (Set)
- No response
- Change MQTT password

QC

Format: QC<Parameter>[CR][LF]
Meaning: MQTT client ID connected to the broker
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: QC\r\n
With Parameter (Set)
- No response
- Change MQTT client ID

QK

Format: QK<Parameter>[CR][LF]
Meaning: MQTT Keep-alive time setting with the broker
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 65535)
Parameter / Return Value:

Ex> 0

The unit of input number is millisecond(ms)
Response

Without Parameter (Get)
- In ASCII: QK0\r\n
With Parameter (Set)
- No response
- Change MQTT Keep-alive time

PU

Format: PU<Parameter>[CR][LF]
Meaning: MQTT publish topic
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: PU\r\n
With Parameter (Set)
- No response
- Change MQTT publish topic

U0

Format: U0<Parameter>[CR][LF]
Meaning: MQTT subscribe topic 1
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: U0\r\n
With Parameter (Set)
- No response
- Change MQTT subscribe topic

U1

Format: U1<Parameter>[CR][LF]
Meaning: MQTT subscribe topic 2
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: U1\r\n
With Parameter (Set)
- No response
- Change MQTT subscribe topic

U2

Format: U2<Parameter>[CR][LF]
Meaning: MQTT subscribe topic 3
Command Type: Read / Write
Parameter / Return Type: String (up to 128-bytes)
Parameter / Return Value: Default: None(null)
Response

Without Parameter (Get)
- In ASCII: U2\r\n
With Parameter (Set)
- No response
- Change MQTT subscribe topic

QO

Format: QO<Parameter>[CR][LF]
Meaning: MQTT QoS level
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 2)
Parameter / Return Value:

Return value	Meaning	Remarks
0	QoS0	-
1	QoS1	-
2	QoS2	-

Response

Without Parameter (Get)
- In ASCII: QO0\r\n
With Parameter (Set)
- No response
- Change MQTT QoS level

Certificate Settings

RC

Format: RC<Parameter>[CR][LF]
Meaning: SSL client Root CA verify option
Command Type: Read / Write
Parameter / Return Type: Number (0 ~ 2)
Parameter / Return Value:

Return value	Meaning	Remarks
0	Client Root CA verify none	-
1	Client Root CA verify optional	-
2	Client Root CA verify required	-

Response

Without Parameter (Get)
- In ASCII: RC0\r\n
With Parameter (Set)
- No response
- Change SSL client Root CA verify option

CE

Format: CE<Parameter>[CR][LF]
Meaning: SSL client certificate enable option
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

Return value	Meaning	Remarks
0	Client certificate disable	-
1	Client certificate enable	-

Response

Without Parameter (Get)
- In ASCII: CE0\r\n
With Parameter (Set)
- No response
- Change client certificate enable option

OC

Format: OC[CR][LF]<Parameter>[CR][LF]
Meaning: SSL client Root CA
Command Type: Write only
Parameter / Return Type: String (up to 2048-bytes)
Parameter / Return Value: Default: None(null)

Possible to also input the client Root CA using the file transfer function of the terminal program.
Response

Without Parameter
- No response
- Change SSL client Root CA

LC

Format: LC[CR][LF]<Parameter>[CR][LF]
Meaning: SSL client certificate
Command Type: Write only
Parameter / Return Type: String (up to 2048-bytes)
Parameter / Return Value: Default: None(null)

Possible to also input the client certificate using the file transfer function of the terminal program.
Response

Without Parameter
- No response
- Change SSL client certificate

PK

Format: PK[CR][LF]<Parameter>[CR][LF]
Meaning: SSL private key
Command Type: Write only
Parameter / Return Type: String (up to 2048-bytes)
Parameter / Return Value: Default: None(null)

Possible to also input the private key using the file transfer function of the terminal program.
Response

Without Parameter
- No response
- Change SSL private key

Command Mode Switch Settings

TE

Format: TE<Parameter>[CR][LF]
Meaning: Serial command mode switch code enable
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:

0: Not used(Disabled)
1: Used(Enabled)

This function must be active in order to enter serial command mode via 3-byte command mode switch code.
Response

Without Parameter (Get)
- In ASCII: TE1\r\n
With Parameter (Set)
- No response
- Change weather command mode switch code enabled or not

SS

Format: SS<Parameter>[CR][LF]
Meaning: Serial command mode switch code
Command Type: Read / Write
Parameter / Return Type: String (3-byte hex only)
Parameter / Return Value: Default: 0x2B 0x2B 0x2B

The command mode switch code must be composed of 3-byte(3 characters) hex code.
Response

Without Parameter (Get)
- In ASCII: SS2B2B2B\r\n
With Parameter (Set)
- No response
- Change command mode switch code

Device Control

EX

Format: EX[CR][LF]
Meaning: Command mode exit
Command Type: Write only (control)
Parameter / Return: None
Response

Without Parameter
- No response
- Command mode exit and switch to data transmission mode
While the serial debug message is being used, the following mode switch message will output via Data/Debug UART ports once the switch to data transmission mode is successful.

> SEG:GW Mode

SV

Format: SV[CR][LF]
Meaning: Save changed settings
Command Type: Write only (control)
Parameter / Return: None
Response

Without Parameter
- No response
- Save changed settings

UF

Format: UF[CR][LF]
Meaning: Copy firmware from firmware binary bank to application bank
Command Type: Read / Write
Parameter / Return:

Ex> 1
Response

Without Parameter (Get)
- In ASCII: UF0\r\n
With Parameter (Set)
- No response
- Change current bank flag
After reset, copy firmware from firmware binary bank to application bank.

RT

Format: RT[CR][LF]
Meaning: Device reboot
Command Type: Write only (control)
Parameter / Return: None
Response

Without Parameter
- No response
- All operations are closed and device reboot
While the serial debug message is being used, the following message will output via data UART

> REBOOT

FR

Format: FR[CR][LF]
Meaning: Device factory reset
Command Type: Write only (control)
Parameter / Return: None
Response

Without Parameter
- No response
- Reset to device factory default setting
> REBOOT

Status I/O

SC

Format: SC<Parameter_0><Parameter_1>[CR][LF]
Meaning: Set status I/O pin S0(PA_10) and S1(PA_01) operation mode
Command Type: Read / Write
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:
Parameter_0 (upper byte)

Parameter / Return value	Meaning	Remarks
0	PHY link status	Default
1	DTR	Data Terminal Ready (RS-232/TTL only)

Parameter_1 (lower byte)

Parameter / Return value	Meaning	Remarks
0	TCP connection status	Default
1	DSR	Data Set Ready (RS-232/TTL only)

Response

Without Parameter (Get)
- In ASCII: (Connection Status) SC00\r\n
- In ASCII: (DTR / DSR) SC11\r\n
With Parameter (Set)
- No response
- Change status I/O pins operation mode

S0

Format: S0<Parameter>[CR][LF]
Meaning: Status I/O pin S0(PA_10) value
Command Type: Read only
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:
When operating via PHY link status pin

Return value	Meaning	Remarks
0	PHY link up	-
1	PHY link down	-

When operating via DTR(Data Terminal Ready) pin
- Signal that the device communication is ready (RS-232, Output)
- Connects with peer device's DSR pin

Return value	Meaning	Remarks
0	The device is not ready	-
1	The device ready for communications	-

Response

Without Parameter (Get)
- In ASCII: S00\r\n

S1

Format: S1<Parameter>[CR][LF]
Meaning: Status I/O pin S1(PA_01) value
Command Type: Read only
Parameter / Return Type: Number (0 / 1)
Parameter / Return Value:
When operating via TCP connection status pin
- TCP client / TCP server / TCP mixed mode only

Return value	Meaning	Remarks
0	TCP connection established	-
1	TCP disconnected	-

When operating via DSR(Data Set Ready) pin
- Signal detect that the peer device communication is ready (RS-232, Input)
- Connect with peer device's DTR pin

Return value	Meaning	Remarks
0	The peer device is not ready	-
1	The peer device ready for communications	-

Response

Without Parameter (Get)
- In ASCII: S10\r\n

W232N AT Command Overview​

Abbreviations​

Usage of Command Set​

Control Device Using Serial Command Mode​

Serial Command Frame Format​

Get Request​

Set Request​

Control Device Using Ethernet Network​

Ethernet Command Frame Format​

Get Request​

Set Request​

Ethernet Command Examples​

Example #1: UDP Get Command Frame​

Example #2: TCP Get Command Frame​

Example #3: TCP Set Command Frame​

Command list​

Basic Commands​

Extended Commands​

Command Descriptions​

Device Information​

MC​

VR​

MN​

ST​

UN​

UI​

Network Settings​

OP​

IM​

LI​

SM​

GW​

DS​

LP​

RH​

RP​

Data UART Settings​

BR​

DB​

PR​

SB​

FL​

EC​

Serial Data Packing Options​

PT​

PS​

PD​

Options​

IT​

CP​

NP​

SP​

DG​

KA​

KI​

KE​

SO​

RI​

MQTT Settings​

QU​

QP​

QC​

QK​

PU​

U0​

U1​

U2​

QO​

Certificate Settings​

RC​

CE​

OC​

LC​

PK​

Command Mode Switch Settings​

TE​

SS​

Device Control​

EX​

SV​

W232N AT Command Overview

Abbreviations

Usage of Command Set

Control Device Using Serial Command Mode

Serial Command Frame Format

Get Request

Set Request

Control Device Using Ethernet Network

Ethernet Command Frame Format

Get Request

Set Request

Ethernet Command Examples

Example #1: UDP Get Command Frame

Example #2: TCP Get Command Frame

Example #3: TCP Set Command Frame

Command list

Basic Commands

Extended Commands

Command Descriptions

Device Information

MC

VR

MN

ST

UN

UI

Network Settings

OP

IM

LI

SM

GW

DS

LP

RH

RP

Data UART Settings

BR

DB

PR

SB

FL

EC

Serial Data Packing Options

PT

PS

PD

Options

IT

CP

NP

SP

DG

KA

KI

KE

SO

RI

MQTT Settings

QU

QP

QC

QK

PU

U0

U1

U2

QO

Certificate Settings

RC

CE

OC

LC

PK

Command Mode Switch Settings

TE

SS

Device Control

EX

SV