enode-host 0.1.15

Host-side tools that interact with the ESP-IDF firmware.

Host Python Tools

This folder contains host-side Python code that interacts with the ESP-IDF firmware (e.g., over serial, sockets, or file exchange). It is kept separate from the firmware build to avoid mixing tool dependencies with ESP-IDF.

Quick start

python -m venv .venv
source .venv/bin/activate
pip install -e .

enode-host --help
enode-host socket 127.0.0.1 3333 "hello"
enode-host gui --port 3333
enode-host map-server --port 8081

Notes

• Add runtime dependencies to pyproject.toml under project.dependencies.
• Keep device/transport details in small modules so they can be shared by scripts and tests.
• The GUI uses wxPython; install it if you plan to run enode-host gui.
• The GUI needs an active X11/Wayland display. On headless hosts, use xvfb-run enode-host gui.
• If the GUI aborts with WebView/EGL errors on Linux, try WEBKIT_DISABLE_DMABUF_RENDERER=1 enode-host gui.
• If WebView still fails, you can disable the map panel with ENODE_DISABLE_WEBVIEW=1 enode-host gui.
• enode-host map-server serves fixed-size RGB viewports assembled from OpenStreetMap tiles so an ESP32 client can show a static map without embedding a full web map stack.
• The default tile URL points at tile.openstreetmap.org. That is acceptable for light development use, but for sustained use you should switch the proxy to your own tile service or self-hosted tiles.

Protocol (TCP, length-prefixed)

Frame format: 1 byte message type, 2 bytes big-endian payload length, payload.

Message types:

• 0x10 COMMAND (host -> device)
• 0x20 STATUS (device -> host)
• 0x30 ACK (either direction)
• 0x40 DATA (device -> host, ACC batch)
• 0x41 PPS (device -> host, immediate PPS)

Commands (payload begins with command_id):

• 0x01 start_daq
• 0x02 stop_daq
• 0x03 set_mode (1 byte: 0 realtime, 1 past)
• 0x04 start_realtime_stream
• 0x05 stop_realtime_stream

Status payload (16 bytes):

• node_type: uint8
• node_number: uint8
• level: uint8
• parent_mac: 6 bytes
• self_mac: 6 bytes
• rssi: int8

DATA payload:

• node_type: uint8
• node_number: uint8
• sample_count: uint8
• repeated samples (count):
  • cc: uint64 (big-endian)
  • acc_x: float32 (big-endian)
  • acc_y: float32 (big-endian)
  • acc_z: float32 (big-endian)

PPS payload:

• node_type: uint8
• node_number: uint8
• cc: uint64 (big-endian)
• epoch: int64 (big-endian)