

Modbus to x
ESP32 based hardware and firmware stack that bridges modbus RTU devices to modern network services.
- Size
- 87.6 × 46.7 mm
- Copper layers
- 4
- Thickness
- 1.6 mm
- Parts
- 58
- Nets
- 71
- Pads
- 231
- Tracks, vias
- 422, 189
- Pours
- 25
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 28 Apr 2025
- Updated
- 21 Oct 2026
Overview
Modbus to x is an open-source printed circuit board by joachimda, from the joachimda/modbus-to-x repository on GitHub, published under the MIT licence. It is a 4-layer board of 87.6 × 46.7 mm with 58 parts on 71 nets, routed with 422 tracks and 189 vias.
It is built around the CH340C, MAX3485CSA+T and LM2596S-3.3-EV, with the RT0603DRE0710KL, GCD21BR71H104KA01L and T495D337K006ATE100 among its other parts. Its parts include 21 resistors, 11 capacitors, 9 diodes, 6 connectors and 4 ICs. It belongs with the home automation and IoT and interfaces and adapters boards and the ESP32 boards of this library.
Main components
12CH340C
SOP-16-20℃~+70℃ 2Mbps 3.3V、5V 50uA 7mA Transceiver USB 2.0 SOP-16 USB Converters ROHSWCH (Nanjing Qinheng Microelectronics)USB ConvertersMAX3485CSA+T
SO-80℃~+70℃ 1 1 10Mbps 2.2mA 32 3V~3.6V Half-Duplex Transceiver SO-8 RS-485 / RS-422 ICs ROHSMaxim Integrated (Analog Devices)RS-485 / RS-422 ICsLM2596S-3.3-EV
TO-263-5LUncategorisedEVVORT0603DRE0710KL
0603-55℃~+155℃ 100mW 10kΩ 75V Thin Film Resistor ±0.5% ±50ppm/℃ 0603 Chip Resistor - Surface Mount ROHSYAGEOChip Resistor - Surface MountGCD21BR71H104KA01L
0805100nF 50V X7R ±10% 0805 Multilayer Ceramic Capacitors MLCC - SMD/SMT ROHSMurataMultilayer Ceramic Capacitors MLCC - SMD/SMTT495D337K006ATE100
CASE-D-7343-31(mm)-55℃~+125℃ 100mΩ@100kHz 330uF 6.3V ±10% CASE-D-7343-31(mm) Tantalum Capacitors ROHSKEMETTantalum CapacitorsPESD0402-140
0402-55℃~+125℃ 0.25pF 10uA 14V 40V Bidirectional ESD IEC 61000-4-2 0402 ESD and Surge Protection (TVS/ESD) ROHSLittelfuseESD And Surge Protection (TVS/ESD)ESY107M050AG3AA
插件-40℃~+105℃ 100uF 3.5mm 3000hrs@105℃ 50V 511mA@120Hz 74mΩ 8mm ±20% 插件 Aluminum Electrolytic Capacitors - Leaded ROHSKEMETAluminum Electrolytic Capacitors - LeadedCL21A226MOCLRNC
080516V 22uF X5R ±20% 0805 Multilayer Ceramic Capacitors MLCC - SMD/SMT ROHSSamsung Electro-MechanicsMultilayer Ceramic Capacitors MLCC - SMD/SMT2920L150/60MR
2920UncategorisedLittelfuseSRR1260-330M
SMD,12.5x12.5mm2.8A 33uH 3A 60mΩ ±20% SMD,12.5x12.5mm Power Inductors ROHSBournsPower InductorsM50-3140545R
SMD,P=1.27mm-40℃~+105℃ 1 1.27mm 1A 3.4mm 500V 5P Surface Mount,Vertical Tin SMD,P=1.27mm Female Headers ROHSHarwinFemale Headers
README
README.mdModbus-to-X
An ESP32-based hardware and firmware stack that bridges RS-485/Modbus field devices to modern network services such as MQTT, with a configuration-first UX for installers and maintainers.
Table of Contents
Overview
Modbus-to-X combines a custom ESP32 carrier board with firmware that polls Modbus RTU devices over RS-485, persists telemetry locally, and republishes structured payloads to MQTT brokers. The firmware exposes an onboard web interface for Wi-Fi provisioning, Modbus configuration, live device statistics, and log retrieval so field technicians can deploy the gateway without recompiling binaries.
Architecture
The project is split between dedicated hardware design files and a PlatformIO firmware project. Hardware-specific documentation lives in hardware/; firmware, tooling, and UI assets live in software/.
Hardware
- Four-layer ESP32 carrier featuring an ESP32-WROOM-32D module, MAX3485 RS-485 transceiver
- RJ12 Connector exposing differential RS-485 pair alongside field power for quick deployment.
- Wide input voltage range (4.5 - 30V)
- Supporting assets include datasheets, the hardware release policy, the compatibility table and a release record for each board revision under
hardware/.
Firmware
- PlatformIO-based ESP32 application primarily built with the Arduino framework.
- Library dependencies: ModbusMaster, PubSubClient, ArduinoJson, and ESPAsyncWebServer for protocol handling and a dynamic UI backend.
- A custom partition table separates user configurations from UI components, leaving user configurations untouched on filesystem uploads.
- Boot sequence mounts filesystem partitions, starts the async web server ("MBX Server"), initializes the Modbus scheduler, and spins up the MQTT manager.
- Configuration data for the Modbus bus, devices, and MQTT settings is stored in
/conf/*.jsonon the dedicated config SPIFFS partition (cfg) and hot-reloaded without reflashing. - MQTT passwords are stored in NVS preferences;
/conf/mqtt.jsoncontains non-sensitive fields. - Default wiring, RS-485 guard times, Wi-Fi AP Portal credentials, and OTA parameters are centralized in
Config.h. - Signed and manual HTTP updates use a bounded quiescence coordinator and a compiled recovery page; the lifecycle and protocol are documented in
OTA_LIFECYCLE.md.
Getting Started
Prerequisites
- Modbus-to-X hardware (v0.2 alpha or later) and Modbus RTU devices wired to the RS-485 terminals.
- 4.5–40 VDC field power (buck input validated in the current design) and a USB-to-UART adapter if not using OTA uploads.
- Development host with Python 3, PlatformIO Core, and a working
gittoolchain. Required Python build dependencies are installed automatically byscripts/install_build_deps.pywhen PlatformIO runs.
Build and Flash
- Clone the repository and enter the firmware workspace:
bash git clone https://github.com/joachimda/modbus-to-x.git cd modbus-to-x/software/modbus-to-mqtt - Choose an environment in
platformio.ini:mbx-custom-board-dev— development build, serial upload (default).mbx-custom-board-dev-ota— development build, OTA upload (reads the device address fromMBX_DEV_OTA_HOSTand the OTA password fromMBX_DEV_OTA_PASSWORD).mbx-custom-board-release— release build (used by the GitHub Actions workflow).mbx-custom-board-release-primer— primes a dev device to receive HTTP OTA updates (same environment variables asmbx-custom-board-dev-ota).
- Build the firmware (PlatformIO will fetch dependencies and embed git metadata):
bash pio run - Flash via USB/UART or OTA by selecting the matching environment:
bash # Serial upload pio run -e mbx-custom-board-dev -t upload # OTA upload to a provisioned gateway; address and password come from your shell export MBX_DEV_OTA_HOST=<device-ip> MBX_DEV_OTA_PASSWORD=<ota-password> pio run -e mbx-custom-board-dev-ota -t upload - Upload the web UI and config assets to SPIFFS when they change:
bash pio run -e mbx-custom-board-dev -t uploadfs
Release Automation
Pushing a v* tag triggers the GitHub Actions workflow in .github/workflows/main.yml to build firmware + filesystem images and create a GitHub Release with the assets:
modbus-to-x.bin(firmware)modbus-to-x.fs.bin(filesystem)modbus-to-x.notes.txt(release notes generated from the commit log since the previous tag)modbus-to-x.manifest.json(includes SHA-256 hashes and a signature generated fromOTA_SIGNING_KEY_PEMandKID).
The same workflow can also be started manually (Actions → "Release OTA" → "Run workflow", or gh workflow run "Release OTA" --ref main -f version=8.0.5-beta). Enter the bare version without the v (8.0.5 or 8.0.5-beta.1); the workflow creates the tag v<version> on the selected ref (gh uses the repository's default branch when --ref is omitted), builds exactly as a tag push would, and pushes the tag together with the release. It refuses to run if that tag already exists or if the selected commit already carries a tag.
Local UI Development
The scripts/run_test_webserver.py helper serves the data/ directory with mocked API responses so you can iterate on the HTML/JS bundle without flashing the device:
cd software/modbus-to-mqtt
python3 scripts/run_test_webserver.py
# Visit http://127.0.0.1:8000It injects correct MIME types, disables caching, and emulates the SPA's system, OTA, and administrative API behavior, including mutation-request protection.
Use --provisioning-scenario delayed, temporary, completion-unavailable, readiness-html, or another listed scenario to exercise captive handoff failures. Running the mock on port 80 allows its loopback station address to complete the full dashboard handoff.
Use --ota-scenario success, failure, or sse-loss to exercise OTA
admission, lifecycle progress, status-poll fallback, recovery, and reboot UI.
HTTP API
See the HTTP API request contract for the route and method matrix, browser cross-site protections, OTA authorization behavior, and non-browser client examples.
Usage
First Boot and Network Setup
- Power the gateway; it will advertise a Wi-Fi AP using the defaults defined in
Config.h(MODBUS-MQTT-BRIDGE/you-shall-not-pass). - Connect to the AP. The ESP will try getting 192.168.4.1 from DHCP. If supported on your OS, you will be prompted to open the Captive Portal and redirected automatically. If these fail, check your router for the device's IP address, and use your browser to open the configuration page
http://192.168.4.1/. - Follow the on-screen guidance to scan, join, or provision hidden networks, optionally specifying static IP parameters before saving.
- After a saved network connection succeeds, the portal requests an acknowledged reboot, waits for the device to return in station mode, and opens the dashboard at the reported address. Temporary connections remain in the portal until a saved attempt succeeds.
Configuring Modbus Devices
- Use Configure Modbus to edit the RS-485 bus, add devices, and define datapoints. Modbus configurations are stored in the config partition at
/conf/config.jsonand can be applied live without rebooting. - Configuration files follow the schema in
software/modbus-to-mqtt/data/conf/schema.json; the excerpt below shows the datapoint fields. Each datapoint specifies the function code, register address, data type, scale, and engineering units that will be published when polled. Registers are decoded bydataTypebefore the scale is applied:int16/uint16use one register (optionally a byte viaregisterSlice),int32/uint32/float32use two andint64/uint64four registers, in thewordOrderbig(default, first register = most significant word) orlittle.numOfRegistersbelow the type's width is raised to it when the configuration loads. FC6 writes one register, so saving FC6 with a 32-bit or 64-bit type is rejected; a stored configuration that already combines them loads asuint16(the encoding every FC6 value had before data types were honoured, so nothing changes for it) with a logged warning. bus.baudmust be an integer of at least 1200, the lowest rate the bus form offers; a configuration below it, or with a non-integer value, is rejected withinvalid_baud_rate. A stored configuration that fails this check is logged at boot and leaves Modbus disabled until it is corrected in Configure Modbus.- Per-device MQTT publishing and Home Assistant discovery can be toggled in the Modbus config; discovery publishes retained entity definitions for read/write datapoints.
Example (excerpt):
json { "devices": [ { "name": "Boiler", "slaveId": 10, "mqttEnabled": true, "homeassistantDiscoveryEnabled": true, "dataPoints": [ { "id": "temp", "name": "Temperature", "function": 4, "address": 100, "numOfRegisters": 1, "dataType": "int16", "scale": 0.1, "unit": "C", "topic": "plant/boiler/temp_c" }, { "id": "flow", "name": "Flow", "function": 3, "address": 200,
Wavin AHC 9000
The Wavin AHC 9000 floor-heating controller (also sold as Jablotron AC-116) uses Modbus RTU framing but answers only its own function codes, so standard reads return IllegalFunction. Use function 67 (0x43, read) and 68 (0x44, write). These address a register by category, page and a register index, which goes in address, each 0-255. Reads cover up to 22 registers; writes set one 16-bit register and follow the FC6 rules.
-
Bus: 38400 baud,
8N1. The controller always answers slave address 1. -
Commonly used registers, from Wavin's Modbus description for the AHC 9000 (14-08-2013, copy in jascdk/wavin_ahc9000_advanced_mqtt) and the community projects (niklascp/Wavin-AHC-9000-mqtt, spiff42/wavin-python), checked on an AHC 9000 with wireless thermostats. Thermostats (elements) and channels are numbered from 0; a channel's page is its output number minus one.
Category Page Index Value 1 (elements) element/thermostat number 2 Channel assignment, bitmask of the channels this thermostat drives 1 (elements) element/thermostat number 4 Air temperature, int16× 0.1 °C1 (elements) element/thermostat number 8 Status; bit 0x8000alive,0x0800lost,0x0200low battery,0x0010is a thermostat1 (elements) element/thermostat number 9 RSSI: high byte at the thermostat, low byte at the controller; signed, 0 = -74 dBm, 0.5 dB per step 1 (elements) element/thermostat number 10 Battery in 10 % steps (9 = 90 %); 0 until the thermostat has reported 1 (elements) element/thermostat number 11 Primary channel (sync group) 2 (packed data) channel number 0 Manual setpoint, int16× 0.1 °C (writable)2 (packed data) channel number 1, 2 Comfort and eco setpoints, int16× 0.1 °C2 (packed data) channel number 4 Standby setpoint, int16× 0.1 °C (writable)2 (packed data) channel number 7 Configuration; low 3 bits are the mode (0 manual, 1 permanent standby, 2 eco, 3 comfort, 4 party, 5 holiday) and bit 0x0008enables the week schedule2 (packed data) channel number 8, 9 Minimum and maximum setpoint the user can set on the thermostat, int16× 0.1 °C. The controller does not clamp 0x44 writes to this range2 (packed data) channel number 16 Desired temperature the channel currently heats to, int16× 0.1 °C (read only)3 (channels) channel number 0 Timer event; bit 0x0010is set while the output is on, the low 4 bits are the current timer event (1 idle, 7 output on)3 (channels) channel number 1 Actuator current in 0.54 mA units 3 (channels) channel number 2 Primary element plus one in the low 6 bits ( 0x00C1= element 0, 0 = no thermostat);0x0400means all thermostats lost;0x0080/0x0040store the party/holiday preference and0x4000means the channel syncs its parameters in the next framejson { "version": 1, "bus": { "enabled": true, "baud": 38400, "serialFormat": "8N1" }, "devices": [ { "name": "Wavin", "slaveId": 1, "mqttEnabled": true, "homeassistantDiscoveryEnabled": true, "dataPoints": [ { "id": "zone1_temp", "name": "Zone 1 temperature", "function": 67, "category": 1, "page": 0, "address": 4, "numOfRegisters": 1, "dataType": "int16", "scale": 0.1, "unit": "C", "poll_interval": 30 }, { "id": "zone1_setpoint", "name": "Zone 1 setpoint", "function": 67, "category": 2, "page": 0, "address": 0, "numOfRegisters": 1, "dataType": "int16", "scale": 0.1, "unit": "C", "poll_interval": 30 }, { "id": "zone1_setpoint_set", "name": "Zone 1 setpoint", "function": 68, "category": 2, "page": 0, "address": 0, "numOfRegisters": 1, "dataType": "int16", "scale": 0.1 } ] } ] } -
The clock (category 5, page 0: year, month, day, weekday with 0 = Monday, hour, minute, second) must be read or written as one 7-register page; single-register writes are not answered.
-
A wall display (DS-9000) may share the bus as a second master. Bytes that cannot be the reply to the outstanding request (another slave or function, more registers than requested, the display's own requests, or a bad CRC) are skipped while waiting. An attempt waits 500 ms for the reply to start (
WAVIN_TURNAROUND_MS) plus the time the reply takes at the bus's baud rate (about 13 ms for 22 registers at 38400 8N1, 409 ms at 1200). A read or 0x44 write that times out or fails its CRC is retried after a random 100–250 ms pause, up to 3 attempts in total (WAVIN_READ_ATTEMPTS,WAVIN_WRITE_ATTEMPTS), but a retry only starts if it still fits the 2000 ms budget for the attempts and their pauses (WAVIN_TRANSACTION_BUDGET_MS, derived from the OTA quiescence bound): at 38400 all three attempts normally fit, at 9600 a 22-register read usually gets two, at 1200 one. After a final failure, input is discarded until the line has been quiet for 50 ms (WAVIN_SETTLE_QUIET_MS), for at most 150 ms (WAVIN_SETTLE_MAX_MS) beyond the budget, so a reply that arrives late is not taken for the reply to the next request. A 0x44 write sets absolute values, so repeating it after a lost reply cannot double-apply; if the same register is changed at the wall display in the 0.6–0.8 s (at 38400) between a lost reply and the retry, the retry overwrites that change (last writer wins, as it does without retries when the display edit follows the write). A reply carrying fewer registers than requested is accepted; only the registers received are decoded.
MQTT Publishing
- Configure broker host, port, credentials, and optional root topic via the Configure MQTT page or by editing
/conf/mqtt.json. The firmware automatically extracts hostnames from URLs and persists the MQTT password in NVS preferences. - When Modbus reads succeed, datapoint values are published to MQTT using either the exact per-datapoint topic override or the default pattern
<root>/<device>/<datapoint>with slugified device and datapoint names. - Published values are decoded by the datapoint's
dataType(andwordOrderfor multi-register types) before the scale is applied, then printed with as many decimals as the scale has (0.01→-2.00,1→1234,0.5→12.5);float32values print the shortest decimal (7 to 9 significant digits) that reads back as the same value;int64/uint64values keep every digit at integral scales and round through double precision at fractional ones. Coils and discrete inputs publish1/0;TEXTdatapoints publish the ASCII content of their registers. A read that returns fewer registers than the data type needs is logged and not published. - A writable datapoint treats its configured
topicas a base and subscribes only to<base>/set; an empty base uses the same default resolution as a readable datapoint before/setis appended. Commands must be published without MQTT retain. There is deliberately no subscription on the legacy base/state topic. - Existing state consumers require no changes. Existing command publishers and automations must migrate from
<base>to<base>/set; retained state left on<base>is safe because the gateway no longer subscribes there. - Home Assistant sensors advertise the resolved state topic. Switches and numbers advertise the derived
/setcommand topic and use a readable datapoint with the same resolved base as state feedback, or remain optimistic when no matching read exists. Number entities advertise the data type's range times the scale asmin/maxand the absolute scale asstep(never below Home Assistant's minimum of0.001). - FC5 coil commands accept only
0,1,false, ortrueafter surrounding whitespace is removed; the words are case-insensitive. - FC6 and FC16 commands accept a complete decimal value with an optional sign, fraction, and decimal exponent. Examples include
12,+12.5,.5,1.,1e3, and-2.5E-2. Hexadecimal,NaN, infinity, and partially numeric text are rejected. - Holding-register commands use
engineering = raw × scale, whererawhas the datapoint'sdataType:int16/uint16occupy one register (FC6 or FC16),int32/uint32/float32two registers andint64/uint64four registers, written with FC16 in the configuredwordOrder. The command value is divided by the configured finite, non-zero scale, rejected if the unrounded result is outside the type's range, and otherwise rounded to the nearest raw integer with exact halves rounded upward;float32values are stored without rounding. Negative scales are supported. FC6 cannot write 32-bit or 64-bit types; saving such a configuration is rejected withinvalid_register_count(a stored one keeps loading asuint16, see above). 64-bit values beyond 2^53 lose precision in the division. - Rejected MQTT commands do not reach the Modbus bus. Their warning contains the command topic, function, address, and a stable reason code, but never echoes the rejected payload.
- MQTT connectivity, Modbus statistics, and recent logs are visible on the dashboard.
OTA Updates
- Release checks and notes retrieval leave normal services running. Applying a release or starting a manual upload first stops ordinary HTTP/SPIFFS activity, Modbus transactions, MQTT reconnect/publication work, and the normal statistics/log stream within bounded deadlines.
- When connected, MQTT publishes the configured retained availability payload before its graceful disconnect. A failed best-effort signal or an already-disconnected broker cannot delay entry indefinitely.
- The dashboard authenticates once into a short-lived RAM-only OTA session, then shows OTA-only SSE progress with public status polling as a fallback. Passwords and session tokens are not stored in the browser.
- Manual firmware and filesystem uploads use a preflight operation and wait for
awaiting_uploadbefore sending image data. A successful operation remains quiescent until reboot; a recoverable failure restores only services that were enabled beforehand. - If the UI filesystem is unavailable,
/serves a self-contained recovery page compiled into firmware. The single filesystem partition is not transactional, so an interrupted filesystem write can still require that recovery path.
See OTA lifecycle and recovery and the HTTP API request contract for exact waits, memory guards, headers, progress fields, and response codes.
Project Structure
.
├── hardware/ # Schematics, PCB layout, BOM assets, release notes
├── software/
│ └── modbus-to-mqtt/ # PlatformIO workspace with firmware, web UI, and tooling
└── README.md # This high-level overviewHardware Documentation
Detailed hardware notes, KiCad sources, datasheets and per-revision release records are kept in hardware/. The release policy is hardware/RELEASING.md and the hardware/firmware compatibility table is hardware/COMPATIBILITY.md. From revision 1.0.0 onwards each released revision has a hw-v<rev> GitHub release carrying the fabrication outputs (gerbers, BOM, placement data, PDFs) and a committed record under hardware/releases/. The prototype spins before 1.0.0 are the v0.1-alpha-hw and v0.2-alpha-hw tags and releases; their v0.1-alpha and v0.2-alpha folders there stay as they were. The KiCad project in hardware/kicad_files/ holds the schematic, layout and libraries. The board-ID resistors and the HW_REV text variable that marks each revision are described in hardware/BOARD-ID.md.
Software Documentation
The firmware entry point, reusable libraries, and static assets live under software/modbus-to-mqtt/. Key references:
src/– firmware modules for Modbus polling, MQTT connectivity, OTA, and the async web server.data/– web UI bundle and config schema served by the device (config data lives in the/confpartition at runtime).docs/configuration_examples/– JSON schemas and examples for Modbus and MQTT configuration.boards/– custom PlatformIO board definition for the production hardware (ESP32, 16 MB flash).
Acknowledgements
- Built on Espressif's ESP32 platform and the open-source libraries listed in
platformio.ini(ModbusMaster, PubSubClient, ArduinoJson, ESPAsyncWebServer). - Component footprints and 3D models sourced from vendor or third-party libraries included under
hardware/kicad_files/lib/with accompanying license terms inhardware/kicad_files/lib/licenses.
Parts
58| Qty | Value | Footprint | References |
|---|---|---|---|
| 9 | 10K | Resistor_SMD:R_0603_1608Metric | R4, R5, R19, R22, R23, R24, R25, R26, R27 |
| 5 | 0.1uF | Capacitor_SMD:C_0805_2012Metric | C2, C4, C7, C10, C24 |
| 5 | 2K | Resistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolder | R3, R18, R20, R21, R28 |
| 4 | LED | LED_SMD:LED_0402_1005Metric_Pad0.77x0.64mm_HandSolder | D1, D4, D5, D6 |
| 3 | 402 | project_footprints:MBX_R_0402_1005Metric | R7, R8, R10 |
| 2 | 330uF | project_footprints:T495D337K006ATE100 | C1, C8 |
| 2 | 620R | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R2, R14 |
| 2 | DSS4160U-7 | project_footprints:SOT65P210X110-3N | Q1, Q2 |
| 2 | PESD0402-140 | project_footprints:PESD0402-140_LTF | D8, D9 |
| 1 | 0.1uF | Capacitor_SMD:C_0603_1608Metric | C3 |
| 1 | 100uF | project_footprints:ESY107M050AG3AA | C6 |
| 1 | 120R | Resistor_SMD:R_1206_3216Metric_Pad1.30x1.75mm_HandSolder | R1 |
| 1 | 1uF | Capacitor_SMD:CP_Elec_4x5.4 | C22 |
| 1 | 22uF | Capacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolder | C25 |
| 1 | 2920L150 | Fuse:Fuse_2920_7451Metric | F1 |
| 1 | 33uH | project_footprints:IND_BOURNS_SRR1260 | L1 |
| 1 | 3983 | project_footprints:SW_3983_ADA | SW4 |
| 1 | 47K | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R15 |
| 1 | 615006138421 | project_footprints:RJ12_615006138421 | J5 |
| 1 | B340LA-13-F | Diode_SMD:D_SMA_Handsoldering | D2 |
| 1 | CH340C | Package_SO:SOIC-16_3.9x9.9mm_P1.27mm | U4 |
| 1 | ESP32-WROOM-32D_M113DH2800PH3Q0 | project_footprints:ESP32-WROOM-32D_ANT_SILK_REMOVED | IC1 |
| 1 | LM2596S-3.3 | project_footprints:TO-263-5_TabPin3_silk_fix | U1 |
| 1 | LOGO | project_footprints:modbus_to_x_logo_40x40mm | G*** |
| 1 | M50-3140545R | project_footprints:HARWIN_M50-3140545R | J4 |
| 1 | MAX3485 | Package_SO:SOIC-8_3.9x4.9mm_P1.27mm | U3 |
| 1 | Micro USB | project_footprints:AMPHENOL_10118194-0001LF | J6 |
| 1 | OpenLog | project_footprints:MBX_PinHeader_1x06_P2.54mm_Vertical | J2 |
| 1 | SMAJ33A | Diode_SMD:D_SMA | D3 |
| 1 | SS12D00G3 | Button_Switch_THT:SW_Slide-03_Wuerth-WS-SLTV_10x2.5x6.4_P2.54mm | SW1 |
| 1 | SS56 | Diode_SMD:D_SMA | D7 |
| 1 | Screw_Terminal_01x04 | TerminalBlock_Phoenix:TerminalBlock_Phoenix_MKDS-1,5-4-5.08_1x04_P5.08mm_Horizontal | J3 |
| 1 | USB_ENABLE | Connector_PinHeader_2.54mm:PinHeader_2x03_P2.54mm_Vertical | J7 |
Similar boards
- 4 layers142 × 90 mm

- 2 layers38.1 × 38.1 mm

- 2 layers65 × 56 mm

- 4 layers70 × 109.2 mm

Manafish
Tropaion/Manafish_Mainboard
The Manafish Mainboard is the main electronics board of the Manafish ROV. It replaces the Raspberry Pi 3B, the USB-connected Raspberry Pi Pico and the wiring between them with one board:
127 partsAGPL-3.0 - 2 layers42.1 × 24.2 mm

- 4 layers95 × 105 mm

Soiling
julianbustamante13/Proyecto-Soiling-PCB
Archivos correspondientes al diseño de PCB del dispositivo medidor de Soiling para paneles solares fotovoltaicos.
86 parts - 2 layers76.2 × 65.3 mm

- 2 layers63 × 58 mm

OPNpool r5
cvonk/OPNpool
Integrates the functionality of a Pentair pool controller into the smart home using ESP32 SoC.
17 parts102
Questions
How big is the Modbus to x PCB?
It measures 87.6 × 46.7 mm and has 4 copper layers, 1.6 mm thick.
What parts does the Modbus to x use?
58 parts, built around the CH340C, MAX3485CSA+T, LM2596S-3.3-EV and RT0603DRE0710KL. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Modbus to x KiCad files?
From the joachimda/modbus-to-x repository on GitHub, at the commit this page was made from: the board is hardware/kicad_files/modbus-to-x.kicad_pcb and its schematic hardware/kicad_files/modbus-to-x.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Modbus to x design in my own project?
Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).