How jlab-sensing/ents-tock works
ENTS-tock is presented as a userspace ENTS implementation for Tock, with embedded sensor firmware, an ESP32 companion, protobuf-based messages, and Python utilities. The principal embedded path is measurement buffering on the STM32 followed by batched LoRaWAN upload; the ESP32 provides command-driven modules over I²C. Python tools encode/decode data, simulate uploads, and support calibration. The README is sparse and sampled source is incomplete, so links are limited to relationships shown in excerpts or the source index.
Main entry points: main.cpp ESP32 Startup · cli.py ENTS CLI · main.cc Core App · node.py Node Simulator
Components 24
STM32 Firmware
- Sensor Drivers
embedded/libents/src/libents/sensors - Measurement FIFO
embedded/libents/src/libents/storage/fifo.c - Core App
embedded/stm32/apps/core/main.cc - LoRaWAN
embedded/stm32/apps/core/lorawan.cc - ESP32 Controller
embedded/libents/src/libents/controller/controller.c - Controller Communication
embedded/libents/src/libents/controller/communication.c
ESP32 Companion
- ESP32 Startup
embedded/esp32/src/main.cpp - Module Dispatcher
embedded/esp32/lib/module_handler/src/module_handler.cpp - WiFi Module
embedded/esp32/lib/module_handler/src/modules/wifi.cpp - microSD Module
embedded/esp32/lib/module_handler/src/modules/microsd.cpp - User Config Module
embedded/esp32/lib/module_handler/src/modules/wifi_userconfig.cpp - Irrigation Module
embedded/esp32/lib/module_handler/src/modules/irrigation.cpp - Power Module
embedded/esp32/lib/module_handler/src/modules/power.cpp
Message Protocol
- Protobuf Messages
proto
Python Utilities
- ENTS CLI
python/src/ents/cli.py - Measurement Encoder
python/src/ents/proto/encode.py - Sensor Protocol
python/src/ents/proto/sensor.py - Node Simulator
python/src/ents/simulator/node.py - Calibration Recorder
python/src/ents/calibrate/recorder.py - Calibration Plots
python/src/ents/calibrate/plots.py
Other components
- Operator
- Physical Sensors
- Dirtviz Service
- Source Measurement Unit
Connections 23
- Operator → Core App: runs firmware
embedded/stm32/apps/core/main.cc - Core App → Measurement FIFO: reads batches
embedded/stm32/apps/core/main.cc - Core App → LoRaWAN: uploads data
embedded/stm32/apps/core/main.cc - Physical Sensors → Sensor Drivers: provide readings
- Core App → ESP32 Controller: uses interface
embedded/stm32/apps/core/main.cc - ESP32 Controller → Controller Communication: uses buffers
embedded/libents/src/libents/controller/controller.c - ESP32 Startup → Module Dispatcher: registers modules
embedded/esp32/src/main.cpp - ESP32 Startup → Module Dispatcher: routes I²C callbacks
embedded/esp32/src/main.cpp - ESP32 Startup → WiFi Module: registers
embedded/esp32/src/main.cpp - ESP32 Startup → microSD Module: registers
embedded/esp32/src/main.cpp - ESP32 Startup → User Config Module: registers
embedded/esp32/src/main.cpp - ESP32 Startup → Power Module: registers
embedded/esp32/src/main.cpp - ESP32 Startup → Irrigation Module: optional module
embedded/esp32/src/main.cpp - Operator → ENTS CLI: invokes commands
python/src/ents/cli.py - ENTS CLI → Measurement Encoder: encodes messages
python/src/ents/cli.py - ENTS CLI → Sensor Protocol: handles sensor data
python/src/ents/cli.py - ENTS CLI → Node Simulator: runs simulation
python/src/ents/cli.py - Node Simulator → Measurement Encoder: encodes readings
python/src/ents/simulator/node.py - Node Simulator → Dirtviz Service: posts uploads
python/src/ents/simulator/node.py - ENTS CLI → Calibration Recorder: records calibration
python/src/ents/cli.py - ENTS CLI → Calibration Plots: creates plots
python/src/ents/cli.py - Calibration Recorder → Source Measurement Unit: controls instrument
python/src/ents/calibrate/recorder.py - Measurement Encoder → Protobuf Messages: serializes messages