Skip to main content

EOE-W55RP20 SNMP Module

Overview​

The EOE-W55RP20 SNMP module is an embedded Ethernet module that adds SNMP management to your equipment. It is built on the WIZnet W55RP20, which combines an RP2040 MCU and a W5500 Ethernet controller in one package. The host MCU only exchanges AT commands over UART. SNMP processing, SNMPv3 authentication and encryption, and TCP/IP are all handled by the module, so the host MCU does not need a network stack.

EOE-W55RP20 SNMP module system diagram: the host MCU talks to the EOE-W55RP20 module over UART with AT commands, and the module talks to the SNMP manager over Ethernet

Key Features​

  • SNMPv1, v2c and v3 agent: GET, GETNEXT, GETBULK, SET, Trap and Inform
  • SNMPv3 security: SHA-1 / SHA-256 authentication and AES-128 encryption
  • Up to 1024 objects, created by number without knowing OIDs or registered at once from a CSV file
  • Confirmed SET: the host MCU approves a written value before it is applied
  • 10/100 Mbps Ethernet with TCP/IP handled by the W5500 hardware, DHCP or static address, DNS
  • 4 TCP/UDP channels for the host MCU, in addition to SNMP
  • 61 AT commands and a web interface for every setting
  • Firmware update over the web interface or UART, verified before installation
  • Diagnostics, watchdog, and factory reset by AT command, web interface or pin

Why EOE-W55RP20 SNMP​

When to Use​

Existing equipment → NMS

You need to connect existing equipment to an NMS (network management system)

SNMPv3 built in

You need SNMPv3 authentication and encryption but would rather not implement it

A small host MCU

The host MCU has no room for an SNMP or TCP/IP stack

Faster development

You want to shorten the time spent on Ethernet hardware design and protocol testing

Advantages​


Feature Details​

  • Supports SNMPv1, v2c and v3. Only v3 is enabled by default; turn on v1 and v2c when you need them.
  • Handles GET, GETNEXT, GETBULK and SET requests.
  • Sends Traps and Informs to up to 4 receivers.
  • Informs are resent a set number of times until the receiver acknowledges them.
  • 11 standard objects such as sysDescr, sysUpTime and sysName are readable from the start, so communication can be checked before any object is created.
  • The device description (sysDescr), name (sysName), contact (sysContact) and location (sysLocation) can be set with AT commands or on the web interface, so each device stands apart in a manager's device list.

Supported Hardware​

This firmware (1.2.0) runs on the following W55RP20-based hardware. To purchase, contact direct@wiznet.io.

WIZ-IP20W232NEOE-W55RP20
WIZ-IP20W232NEOE-W55RP20
Mag Jack module
3.3 V TTL UART
DIN-rail converter
RS-232 (D-SUB9)
Castellated module
3.3 V TTL UART

Documentation​

This section provides the reference documentation for the module's AT command interface.

TitleDescriptionLink
AT Command GuideAll 61 AT commands, responses, URCs and error codeslink EN

Setup & Configuration​

This section provides step-by-step guides for connecting the module, setting up an SNMP manager and updating the firmware.

TitleDescriptionLink
Getting Started GuideStep-by-step guide from wiring to reading a value over SNMPlink EN
SNMP Setup GuideConnecting an SNMP manager, communities, OID mapping, CSV registration, Traps and Informslink EN
Firmware Update GuideUpdating the firmware through the web interface or AT commands (UART)link EN

Specifications​

ItemValue
Objects1024 (up to 128 of them strings)
SNMPv3 users4
v1/v2c communities4
Trap/Inform receivers4
TCP/UDP channels4
Socket send size1460 bytes
AT command line256 bytes

Hardware Connections​

SignalEOE-W55RP20WIZ-IP20W232NI/ODescription
AT command portGP4 (TX) · GP5 (RX)P5 (TXD) · P3 (RXD)DB9 3 (TXD) · 2 (RXD)O · I115200 8N1 by default, no flow control
AT port flow controlGP6 (CTS) · GP7 (RTS)P6 (CTS) · P10 (RTS)DB9 8 (CTS) · 7 (RTS)I · OConnect only if flow control is used
HandshakeGP8 (DTR) · GP9 (DSR)NoneDB9 4 (DTR) · 6 (DSR)I · ODSR high means the module is ready for commands
Status outputsGP10 · GP11P13 (LINKLED) · NoneLINK · TCP LEDsOEthernet link · TCP connection present
Factory reset inputFACT RSTn (GP18)NoneSwitch inside the caseIInternal pull-up. Hold low for 5 s or more to reset
Debug consoleGP0 (TX) · GP1 (RX)NoneNoneO · I921600 8N1, separate from the AT port
  • The W232N's DB9 is at RS-232 level. The EOE-W55RP20 and WIZ-IP20 pins are 3.3 V TTL.
  • The WIZ-IP20's P13 (LINKLED) and P1 (ACTLED) are the link and activity LED signals driven directly by the Ethernet chip, and they are low when lit (GP10 and GP11 are high). The WIZ-IP20 has no DTR/DSR pins, so DTR/DSR flow control cannot be used on it.
  • The AT port speed can be set from 9600 to 921600 bps.
  • Flow control: none, RTS/CTS, DTR/DSR or XON/XOFF.
  • For power, operating temperature, dimensions and other electrical and mechanical specifications, see the module hardware datasheet.

Quick Start​

  1. Connect the AT port at 115200 8N1, send AT and check that OK comes back.
  2. Set the address. Choose DHCP or static with AT+NETMODE, then apply it with AT+SAVE.
  3. Create an SNMPv3 user. Do not forget AT+SAVE after AT+USMADD.
  4. Check that the manager can read the module, then create objects and send values.
note

From the factory the module uses the static IP 192.168.11.2 and has no SNMPv3 users. Reading it before a user exists gives an Unknown user name error in the manager. It is the error most often seen on a first connection.

For example, publishing a temperature value over SNMP looks like this:

AT+OBJADD=1,"temperature",Integer32,RO,VOLATILE    create the object (once)
AT+SAVE store the definition
AT+OBJVAL=1,253 update the value

A manager reading 1.3.6.1.4.1.52942.1.0 now gets 253. When the value changes, send AT+OBJVAL again.

The full procedure is in the Getting Started Guide.


Customization Services​

WIZnet offers customization services for your specific needs. Based on the EOE-W55RP20 SNMP module, the following can be changed or added to suit your application:

  • Changing the factory defaults
  • Changing the MAC address
  • Preloading the end-product manufacturer's identity (sysObjectID and enterprise number) and object set
  • Adding protocols
  • Adding functions

The customized firmware is programmed into the W55RP20 and delivered.

To request customization, fill in the customization service request form.