EOE-W55RP20 SNMP Module AT Command Guide
Firmware 1.2.0 · 61 commands
AT commands are exchanged on uart1 (GP4 TX / GP5 RX). The factory default is
115200 8N1, no flow control.
The console log goes out separately on uart0, so it never mixes into the AT port.
For installation and connecting an SNMP manager, see the SNMP Setup Guide.
| Chapter | Contents |
|---|---|
| Chapter 1 | Syntax and rules |
| Chapter 2 | Command list |
| Chapter 3 | Device control |
| Chapter 4 | Network |
| Chapter 5 | SNMP agent and product identity |
| Chapter 6 | SNMPv3 users and communities |
| Chapter 7 | Objects and OID mapping |
| Chapter 8 | Notifications (Trap · Inform) |
| Chapter 9 | TCP · UDP socket channels |
| Chapter 10 | Web management |
| Chapter 11 | Firmware update (OTA) |
| Chapter 12 | URCs (unsolicited messages) |
| Chapter 13 | Error codes |
| Chapter 14 | Alphabetical index |
1. Syntax and rules
1.1 Forms
AT check the module answers
AT+NAME=<value> set
AT+NAME? query
AT+NAME execute (action without arguments)
AT+NAME=? test (not executed)
Each command supports different forms. They are listed in the table in Chapter 2 Command list.
1.2 Rules
| Item | Value |
|---|---|
| Case | Command names and keywords are case-insensitive |
| Strings | Enclose in double quotes. A comma inside quotes is not a separator |
| Numbers | Decimal and 0x hexadecimal are both accepted. Leading zeros are ignored (0161 = 161) |
| Line ending | CR, LF and CRLF are all accepted. Responses always end with CRLF |
| Line length | 256 bytes maximum. Longer lines are not executed: ERROR:BUFFER_TOO_LONG |
| Arguments | 12 maximum |
- More arguments than required are refused.
AT+IP="1.2.3.4",5returnsERROR:INVALID_PARAMETERand the address is not changed. - A query must end at
?.AT+OBJVAL?900andAT+VERSION?xreturnERROR:INVALID_PARAMETER. No query takes arguments. - To skip an argument in the middle, keep its comma:
AT+USMADD="mon",NOAUTHNOPRIV,,,,,MONITOR - Out-of-range values and negative numbers are refused as they are, never adjusted.
A port number is 1 … 65535 in every command; outside that the result is
ERROR:VALUE_OUT_OF_RANGE. AT+NAME=?is the test form. The command is not executed; the answer isOKif it has a set form andERROR:INVALID_COMMANDif it does not.
1.3 Responses
Every command ends with a single OK on success or ERROR:<code> on failure
(Chapter 13). Queries and some set commands send one or more
+NAME:... lines before that.
AT+SNMPPORT?
+SNMPPORT:161
OK
1.4 When settings take effect
Set commands change memory only. Storing to flash and actually applying the
settings is done by AT+SAVE.
AT+NETMODE=STATIC
AT+IP="192.168.0.100"
AT+MASK="255.255.255.0"
AT+GW="192.168.0.1"
AT+SAVE
Commands that act immediately, without AT+SAVE:
| Command | Why |
|---|---|
AT+OBJVAL · AT+SETACK | Values, not settings |
AT+SOCK* | Channels are not stored |
AT+TRAPSEND · AT+INFORMSEND | Send actions |
AT+OTAFWUP | Receive action |
AT+OIDMAPRELOAD · AT+OIDMAPCLEAR | Change the mapping directly |
AT+FACTORY · AT+REBOOT · AT+OTAREBOOT | Reboot immediately |
AT+OBJADD and AT+OBJDEL change the object table immediately, but without
AT+SAVE the change is gone at the next boot.
1.5 Binary mode
AT+SOCKSEND and AT+SOCKSENDTO declare a length first, then accept exactly that
many bytes of raw data after the > prompt.
AT+SOCKSEND=0,5
> HELLO
+SOCKSEND:0,5
OK
- In binary mode
CR,LF,NULand even the lettersATare all data. - No line break follows the
>prompt. In the bytes the module sends, the result arrives on the same line as the prompt, as in> +SOCKSEND:0,5. A host that reads line by line should recognise the prompt as the two bytes>, not as a line, and strip a leading>from the result line. - Send all the declared bytes within 10 seconds of the prompt. After 10 seconds
the command ends with
ERROR:PAYLOAD_TIMEOUT, even if bytes are still arriving. - End command lines with
CRLF. AnLFright after aCRis taken as the end of the line and dropped, so a host that ends lines withCRalone loses the first byte of a payload that starts withLF(0x0A). - On a port configured for 7 bits or
XONXOFF, the transfer is refused before it starts (ERROR:NOT_SUPPORTED).
1.6 Limits
All lengths are in bytes. Non-ASCII characters take more than one byte in UTF-8 (a Korean character, for example, takes 3).
| Item | Limit | If exceeded |
|---|---|---|
| AT line | 256 | BUFFER_TOO_LONG |
| Arguments | 12 | INVALID_PARAMETER |
| Socket send | 1460 | BUFFER_TOO_LONG |
| Object name | 19 | INVALID_PARAMETER |
| Object string value | 63 | INVALID_PARAMETER |
String value of a PERSISTENT object | 44 | BUFFER_TOO_LONG |
| Object OID | 16 arcs, 20 bytes encoded | OID_TOO_LONG |
| SNMPv3 user name | 32 | INVALID_PARAMETER |
| Authentication · privacy password | 63 | INVALID_PARAMETER |
| Community name | 32 | INVALID_PARAMETER |
| Web account | 23 | INVALID_PARAMETER |
| Web password | 63 (minimum 8) | INVALID_PARAMETER |
| Socket host name | 63 | INVALID_PARAMETER |
| Item | Count |
|---|---|
| Objects | 1024 (of which 128 can be strings) |
| SNMPv3 users | 4 |
| Communities | 4 |
| Notification receivers | 4 |
| Socket channels | 4 |
The string value limit depends on the path: 63 bytes over AT, 64 bytes over an
SNMP SET, and 44 bytes for a PERSISTENT object (AT+OBJVAL).
2. Command list
| Column | Meaning |
|---|---|
| Set | Supports the AT+NAME=<value> form |
| Query | Supports the AT+NAME? form |
| Exec | Supports the AT+NAME form |
| Save | ● means AT+SAVE is required. — means the command stores by itself |
2.1 Device control (Chapter 3)
| Command | Set | Query | Exec | Save | Function |
|---|---|---|---|---|---|
AT | ● | Check the module answers | |||
AT+SAVE | ● | — | Store settings to flash and apply | ||
AT+REBOOT | ● | — | Close connections and reboot | ||
AT+FACTORY | ● | — | Factory reset | ||
AT+VERSION | ● | Firmware, model, serial, product ID | |||
AT+DIAG | ● | Statistics and diagnostics | |||
AT+UART | ● | ● | ● | AT port settings |
2.2 Network (Chapter 4)
| Command | Set | Query | Exec | Save | Function |
|---|---|---|---|---|---|
AT+NETMODE | ● | ● | ● | DHCP / STATIC | |
AT+IP | ● | ● | ● | IP address | |
AT+MASK | ● | ● | ● | Subnet mask | |
AT+GW | ● | ● | ● | Gateway | |
AT+DNS | ● | ● | ● | DNS server |
2.3 SNMP agent (Chapter 5)
| Command | Set | Query | Exec | Save | Function |
|---|---|---|---|---|---|
AT+SNMP | ● | ● | ● | Agent on/off | |
AT+SNMPPORT | ● | ● | ● | Listening port (default 161) | |
AT+SNMPVER | ● | ● | ● | SNMP versions answered (default 3) | |
AT+ENGINEID | ● | Engine ID (read-only) | |||
AT+ENGINEBOOT | ● | Engine boot count | |||
AT+SYSOBJID | ● | ● | ● | sysObjectID | |
AT+SYSDESCR | ● | ● | ● | sysDescr (description) | |
AT+SYSNAME | ● | ● | ● | sysName (host name) | |
AT+SYSCONTACT |