E02 Modbus I/O Module — Datasheet & Manual

Datasheet & User Manual · MODEL E02XXXX · Document rev 1.1 · 2026-06-18

1. Overview

The EDGE 2IO Modbus I/O Module is an industrial I/O device with 2 configurable analog/digital inputs and 1 analog output. It is exposed simultaneously over Modbus TCP (Ethernet) and Modbus RTU (RS-485), sharing one register map, and is discoverable on the LAN via mDNS / Zeroconf. A supervisory platform browses mDNS, reads capability metadata from TXT records, then polls/controls the device — no static IP or manual register-map documentation required for integration.

2. Key Features

I/O

2× inputs, each: Digital, 0–10 V, or 4–20 mA
1× analog output 0–5 Vdc (0–100 %)
Single-colour status LED

Connectivity

Modbus TCP over Ethernet, port 502
Modbus RTU over RS-485 (concurrent)
mDNS service advertisement
DHCP client (static IP optional)

Configuration

All params via Modbus registers
NVS persistence (survives reboot)
SoftAP web portal for provisioning

Safety

Configurable fail-safe output on link/master loss
Output OFF at boot until first write
4–20 mA wire-break detection

3. Specifications

Parameter	Value
Power supply	24 Vdc
Firmware	e02_modbus v1.0.3
Inputs	2 × (Digital / 0–10 V / 4–20 mA), software-selectable per channel
Output	1 × analog 0–5 Vdc, 0–100 %
Ethernet	10 Mbps, full-duplex (RJ45)
Serial	RS-485 half-duplex (terminals A / B)
Protocols	Modbus TCP (port 502) + Modbus RTU, concurrent; mDNS
Addressing	DHCP client; static IP fallback configurable

4. Pin Layout (MODEL E02XXXX)

24-pin terminal block. Ethernet is on the separate RJ45 jack.

No	Symbol	Type	Description
1	Vss	Power	Power supply ( 24 Vdc )
2	GND		GND ( 0 Vdc )
3	Vss		Power supply ( 24 Vdc )
4	GND		GND ( 0 Vdc )
5	DI1+	Digital Input	Positive signal digital input ( 24/0 Vdc type )
6	DI1-		Negative signal digital input ( 24/0 Vdc type )
7	DI2+		Positive signal digital input ( 24/0 Vdc type )
8	DI2-		Negative signal digital input ( 24/0 Vdc type )
9	O+	Analog Output	Positive signal output ( 5/0 Vdc type )
10	O-	Analog Output	Negative signal output ( 5/0 Vdc type )
11	J1	Debug	For setting ( shorting J1 and J2 for setup mode )
12	J2	Debug	For setting ( shorting J1 and J2 for setup mode )
13	SDA	I2C	I2C pin
14	SCL	I2C	I2C pin
15	A	Modbus	D+ ( modbus rtu signal )
16	B	Modbus	D- ( modbus rtu signal )
17	V1+	Analog Input	Positive voltage signal input ( 0-10 Vdc type )
18	V1-		Negative voltage signal input ( 0-10 Vdc type )
19	V2+		Positive voltage signal input ( 0-10 Vdc type )
20	V2-		Negative voltage signal input ( 0-10 Vdc type )
21	A1+		Positive current signal input ( 0-20 mA type )
22	A1-		Negative current signal input ( 0-20 mA type )
23	A2+		Positive current signal input ( 0-20 mA type )
24	A2-		Negative current signal input ( 0-20 mA type )

Each logical input has voltage (V) and current (A) terminals plus a digital mode; the active source is chosen by the channel's input-mode register (see §5.1). Connect J1–J2 at power-on to enter setup/provisioning mode.

5. I/O Channels

5.1 Inputs

Each input's mode is set by its mode register (0=Digital, 1=4–20 mA, 2=0–10 V, 3=Count). Values are reported over Modbus in engineering units:

Mode	Reported value	Example
Digital	`0` / `1` (debounced, 3 consistent reads @ 10 ms)	1 = high
4–20 mA	centi-mA (mA × 100)	`2000` = 20.00 mA
0–10 V	centi-volt (V × 100)	`1000` = 10.00 V
Count	accumulated rising edges on the digital input (wraps at 65535, resets on reboot)	`1234` = 1234 pulses

In 4–20 mA mode a reading below ~3.5 mA sets the wire-break status flag.

Invert: any digital input can be inverted (report 0↔1) via the config portal — set the Invert inputs bitmask (bit 0 = input 1, bit 1 = input 2). Applies to Digital and Count modes; use it when the field wiring/sensor is active-low. Default off.

5.2 Output

The output register holds a percentage 0–100, scaled to the 0–5 Vdc analog output (terminals O+ / O−). Writes take effect immediately. At boot and during fail-safe the output is forced to a defined value (default 0 %).

6. Network & Discovery

DHCP client by default; static IP configurable via provisioning.
Hostname: e02-<wifi_mac_no_colon>.local
mDNS service: edge_modbus._tcp.local, port 502

TXT records (capability advertisement):

Key	Example	Meaning
`model`	e02_modbus	Device model
`fw`	1.0.0	Firmware version
`i`	2	Input channels
`o`	1	Output channels
`unit`	1	Modbus unit/slave ID
`proto`	modbus-tcp	Protocol identifier
`mac`	B4E62DDE225D	WiFi MAC (no colons)

7. Modbus Interface

Parameter	TCP	RTU (RS-485)
Role	Slave / Server (always)	Selectable: Off / Slave / Master
Transport	Ethernet (RJ45) or WiFi, port 502	RS-485 (terminals A / B)
Address	Unit ID (MBAP)	Slave address = Unit ID register
Default line	—	9600 baud, 8N1 (configurable)
Function codes	03 (read holding), 06 (write single holding); as a master it also issues 04 (read input)
Byte order	Big-endian (standard Modbus)

RS-485 mode, baud / parity / stop-bits and the unit/slave id take effect after a reboot (the Modbus controllers are created once at startup).

7.1 RS-485 modes

There is a single RS-485 port, so it is either a slave or a master — never both. Modbus TCP keeps serving as a slave in all three modes.

Mode	Value	Behaviour
Off	0	RS-485 idle; TCP only.
Slave	1	Default. A remote master reads/writes this device over RS-485, sharing the same registers as TCP.
Master	2	This device polls remote slaves and republishes what it reads into its own registers, so a TCP client reads local I/O and remote values from one table. See §8.1.

8. Register Map (Holding Registers)

Read with FC 03, write with FC 06. Layout: configuration block first, then live I/O.

Addr	Register	Access	Persist	Notes
0	Unit ID / RTU address	R/W	NVS	1–247; effective after reboot
1	Input 1 mode	R/W	NVS	0=Dig, 1=4–20 mA, 2=0–10 V, 3=Count
2	Input 2 mode	R/W	NVS	same
3	Fail-safe output value	R/W	NVS	percent 0–100
4	Fail-safe timeout (s)	R/W	NVS	0 = disabled
5	RS-485 mode	R/W	NVS	0=off, 1=slave, 2=master; effective after reboot
6	RTU baud / 100	R/W	NVS	96=9600 … 1152=115200
7	RTU parity	R/W	NVS	0=none, 1=odd, 2=even
8	RTU stop bits	R/W	NVS	1 or 2
9	Input 1 value	R	—	scaled (see §5.1)
10	Input 2 value	R	—	scaled (see §5.1)
11	Output	R/W	—	percent 0–100 (→ 0–5 Vdc)
12	Status flags	R	—	bitfield (below)
13	Master poll status	R	—	bit i = poll entry i failed (master mode only)
14–45	Master poll results	R	—	remote registers, packed in entry order (master mode only)

Registers 13–45 exist on every build but read 0 unless RS-485 is in master mode. Addresses 0–12 are unchanged from earlier firmware.

Status flag bits (register 12)

Bit	Mask	Meaning
0	0x01	Ethernet link / IP up
1	0x02	Modbus master polled recently (any transport)
2	0x04	Input 1 wire-break (4–20 mA < 3.5 mA)
3	0x08	Input 2 wire-break
4	0x10	Output forced to fail-safe
5	0x20	RS-485 running as a slave
6	0x40	RS-485 running as a master (polling)

8.1 RS-485 master mode — polling plan

In master mode the device polls up to 8 entries, each a block read from one remote slave, repeating the whole sweep every sweep interval (default 1000 ms, min 100 ms). Entries are configured in the web portal (§11.2) as slave,fc,start,count.

Field	Range	Meaning
`slave`	1–247	remote device address on the RS-485 bus
`fc`	3 or 4	3 = read holding registers, 4 = read input registers
`start`	0–65535	first register address on the remote device
`count`	1–16	how many consecutive registers to read

Results are packed in entry order starting at register 14, up to 32 registers in total. Example:

Entry	Configured as	Lands in
P0	`5,3,100,4`	registers 14–17 (slave 5, holding 100–103)
P1	`7,4,0,2`	registers 18–19 (slave 7, input 0–1)

If a remote device stops answering, its result registers keep their last good values and the entry's bit is set in register 13. Always check register 13 before trusting a value — a held reading is indistinguishable from a live one otherwise.

Unused or invalid entries are skipped and take no result registers; they are reported on the serial console at boot. A total exceeding 32 registers drops the overflowing entries.

9. Status LED

State	LED	Meaning
Provisioning	Fast blink	Config mode (SoftAP portal active)
Initializing	Slow blink	Booting, network not ready
Running	Solid ON	Normal operation (Modbus serving)

10. Fail-safe & Boot

Boot: output initialised OFF (0 %) until the first valid write.
Fail-safe trigger: Ethernet link down, or no Modbus master access within the fail-safe timeout (register 4, if > 0).
Fail-safe action: output driven to the fail-safe value (register 3).

Boot sequence: init I/O + safe output (LED slow-blink) → bring up Ethernet, acquire DHCP → start mDNS + Modbus TCP/RTU slaves (LED solid) → enter input-poll loop.

11. Configuration (Manual)

11.1 Via Modbus

Write configuration registers (0–8) with FC 06. Config values persist to NVS. Transport/serial params (unit id, RTU baud/parity/stop/enable) apply on the next reboot; input modes, output and fail-safe values apply live.

11.2 Config mode — SoftAP web portal

Every firmware (Converter and Timestamp) uses the same way to enter config mode; only the settings shown on the page differ by firmware.

You can also configure a running device over the network. The same page is served on the device's normal LAN address (http://<device-ip>/) during operation — no jumper needed. It asks for a password (any user name; default edge12345, change it under Security on that page), because it shows the stored WiFi and MQTT passwords. Use the SoftAP route below when the device has no usable network yet.

Enter config mode (identical for all firmwares):

Short J1–J2 (terminals 11–12) at power-on / reset — the LED blinks fast.
Join WiFi AP E02-xxxxxx (password edge12345).
Open http://192.168.4.1/.
Save & Reboot → settings persist to NVS and the device reboots into normal operation.

Common to all firmwares — network:

Field	Purpose
WiFi SSID / Password	WiFi STA join (blank SSID = WiFi off)
WiFi static IP + IP / Gateway / Subnet / DNS1 / DNS2	fixed IP on WiFi (unchecked = DHCP)
Ethernet static IP + IP / Gateway / Subnet / DNS1 / DNS2	fixed IP on Ethernet (unchecked = DHCP)

Converter firmware — Modbus settings (shown only on the Converter build):

Field	Purpose
Unit ID / RTU address	Modbus slave id
Input 1 mode / Input 2 mode	0=Digital, 1=4–20 mA, 2=0–10 V, 3=Count
Fail-safe output % (0–100)	output applied on Modbus loss / boot
Fail-safe timeout s	0 = disabled
Invert inputs (bitmask)	bit 0 = input 1, bit 1 = input 2 (report 0↔1)
RS-485 Modbus RTU mode	Off / Slave / Master (applies on reboot) — see §7.1
Baud / Parity / Stop bits	RS-485 line settings, both modes (applies on reboot)
Sweep interval ms	Master mode: how often the whole polling plan repeats (min 100)
P0 … P7	Master mode: polling plan, one entry per box as `slave,fc,start,count`; blank = unused. See §8.1

Timestamp firmware — MQTT / event settings (shown only on the Timestamp build): broker host/port, client id, username, password, device code, NTP server and Input edge. See §15 · Provisioning for the full list.

Security: Modbus is unauthenticated (per the standard). Deploy only on trusted networks. Change the default SoftAP password per site policy.

12. Firmware Update

Update the firmware over USB from a Chrome / Edge browser — no tools to install. Open the web flasher, pick the model and version, connect, and flash:

flasher.technimal.co.th

Stored configuration (unit id, modes, RS-485, etc.) is preserved across an update unless you choose Erase device.

13. Calibration

For best accuracy, calibrate the analog inputs with a 2-point reference per mode (e.g. apply 0 V & 10 V on a voltage input, 4 mA & 20 mA on a current input) and confirm the reported values match a reference meter.

14. Troubleshooting

Symptom	Check
No IP / not discoverable	Ethernet cable & RJ45 link; DHCP server present; LED stuck slow-blink = no IP yet
TCP master can't connect	Confirm the device IP, port 502 open, only the needed master polling
RTU no response	RS-485 mode = 1 (slave) in reg 5; matching baud/parity/stop & slave address; A/B terminals (15/16) & ground
Master poll fails (bit set in reg 13)	RS-485 mode = 2; remote slave address / FC / register range correct; matching line settings; A/B wiring & termination
Analog values wrong	Calibrate the analog inputs (§13); verify the input-mode register & wiring (V/A terminals)
Output not changing	Write percent 0–100 to register 11; check fail-safe isn't active (status bit 4)
Can't enter config mode	Short J1–J2 (terminals 11–12) at power-on; LED should switch to fast blink

15. Timestamp Firmware (variant)

An alternative firmware for the same board that timestamps input edges (proximity / counting sensors) and streams each event to the new_owl IIoT platform over MQTT — instead of the Modbus register interface. Select Timestamp Firmware in the web flasher. Same pinout & terminals.

Item	Behaviour
Inputs	Both 2 digital inputs are edge event inputs with a selectable capture edge (rising / falling / both, set in the config portal). No input-mode selection — single fixed function.
Per event	Publishes `{"tags":{"inK":1},"ts":<epoch_ms>}` to `device/<device_code>/telemetry` (K = input 1–2).
Timestamp	Each edge is stamped locally from an SNTP-synced clock (epoch ms). The server honours the device timestamp, so buffered / back-dated events keep their real event time.
Store-and-forward	RAM ring buffer (2048 events) retries on network / broker outage or backpressure; QoS 1 with delivery ack (an event leaves the buffer only after the broker confirms).
Broker	MQTT (EMQX), plain TCP port 1883.

Throughput & buffering

Two independent ceilings apply — how fast edges can be captured, and how fast events can be delivered to the server. Event timestamps are stamped in the interrupt at microsecond resolution, so timing stays accurate even when delivery lags.

Limit	Value	Set by
Capture rate (per input)	set by the configurable debounce (default 1 ms → up to 1 kHz): edges closer together than the debounce on the same input are discarded. Max rate per input ≈ 1000 / debounce_ms. Inputs are debounced independently, so the aggregate is 2× that across the 2 inputs.	debounce setting (config portal)
Timestamp resolution	microsecond (captured in the ISR) — buffered / back-dated events keep their true event time	hardware timer
Sustained delivery (to server)	one QoS 1 publish at a time (waits for the broker `PUBACK` before the next), so the continuous rate ≈ 1 / broker round-trip: ~200–1000 ev/s on the same LAN, ~65–200 ev/s over WiFi to a LAN broker, ~10–30 ev/s across the internet	QoS 1 ack round-trip (network)
Burst headroom	2048 events — short bursts above the sustained rate are buffered in RAM and drained later. If the average input rate stays above the sustained delivery rate, the buffer fills and the oldest events are dropped.	RAM ring buffer size

Typical proximity / counting use (< 50 Hz) sits well within every limit. For higher sustained rates: shorten the debounce (cleaner signals only), or batch several events per MQTT message (requires a matching change on new_owl).

Provisioning

Create the device on the new_owl server, then copy its MQTT fields into the config portal (short J1–J2 at boot → http://192.168.4.1/):

Portal field	From the new_owl device
Broker host / port	your EMQX broker (platform host : 1883)
Client ID	`mqtt_client_id`
Username	`mqtt_username`
Password	`mqtt_password`
Device code	`device_code` → topic `device/<code>/telemetry`
NTP server	a reachable NTP host (default `pool.ntp.org`) — needed for event epoch time
Input edge	capture edge: `0`=rising, `1`=falling, `2`=both (default `0`)
Debounce ms	blanking time after an accepted edge, per input (default `1`, `0`=off, max 10000) — see below

Tuning the debounce

A noisy or bouncing sensor can register several edges for one real pulse, inflating counts. Raising the Debounce ms value ignores further edges on that input for the given time.

Do not set it higher than needed. The debounce is also a hard rate limit: real pulses arriving closer together than the debounce are silently discarded. Keep it below the shortest genuine gap between pulses — max rate ≈ 1000 / debounce_ms (e.g. 50 ms caps that input at ~20 Hz).

The device log (viewable in the web flasher) prints a status line every 5 seconds:

status: link=1(eth=1,wifi=0) mqtt=1 time=1 | in=[01] buf=0 captured=12 sent=12 dropped=0 bounced=37

Symptom	Meaning	Action
`bounced` rising, counts now correct	debounce is filtering the noise	keep the current value
`bounced` ~0 but counts still too high	the extra counts are not bounce (wiring / EMI / wrong edge)	check wiring and Input edge, not the debounce
real pulses missing	debounce exceeds the pulse interval	lower it

Inputs use no internal pull — the board's opto-isolated input circuit drives the level (idle high, pulled low when 24 Vdc is applied across DI+/DI−). Pick the Input edge to match your sensor: capture on the assertion (24 V applied → falling) with 1, or on release (rising) with 0; both give the same pulse count. WiFi & static IP are configured as usual; the device also connects over Ethernet. Events captured before the clock syncs or while offline are buffered and sent with their correct timestamp once connected.

16. Edge-MQTT Firmware (variant)

A third firmware for the same board. It samples the I/O on a fixed interval and publishes the readings as named tags to the new_owl platform over MQTT — what the legacy Edge firmware did over CoAP, but with every setting entered in the web portal instead of being pushed by the server. Select Edge-MQTT Firmware in the web flasher. Same pinout & terminals.

Item	Behaviour
Sources	the 2 local inputs, plus any registers read from remote slaves in RS-485 master mode. Only channels you give a tag name to are published.
Per publish	`{"tags":{"<your_tag>":<value>,...},"ts":<epoch_ms>}` to `device/<device_code>/telemetry` — the same shape the Timestamp firmware uses, so new_owl auto-creates the tags from the names you choose.
Interval	Publish interval s in the portal (default 60 s, range 1–3600).
Store-and-forward	RAM ring of 48 payloads; samples taken while the broker is unreachable are sent later with their original timestamp. QoS 1 — a payload leaves the buffer only once the broker confirms it. Oldest is dropped if the buffer fills.
Not included	no Modbus slave interface (nothing reads this device), and no commands from the server — it only publishes.

Naming the tags

Portal field	Meaning
Input 1–2 tag	tag name for that local input. Blank = not published.
Poll entry `P0..P7`	one remote read per box, written as `tag,slave,fc,start,count,dtype,order`. `fc`: 3=holding, 4=input. `dtype`: 0=u16, 1=s16, 2=u32, 3=s32, 4=float32. `order`: 0=high word first (Modbus default), 1=low word first. `count` is how many registers make up the value (1 for 16-bit, 2 for 32-bit). Each entry becomes one tag; a blank tag is not published.

An entry whose last sweep failed is skipped rather than published with a stale value, so a dead slave leaves a gap in the series instead of a flat line. MQTT, NTP, WiFi and static IP are configured exactly as for the Timestamp firmware (§15).