User Guide Overview¶
This guide walks through the end-to-end process of setting up, configuring, and deploying an ENTS sensing node, and visualizing collected environmental data in the DirtViz web platform.
Deployment Workflow¶
Setting up an ENTS sensor node involves four primary steps:
flowchart TD
Step1["Step 1: Web Setup\n• Log in to DirtViz\n• Create a Cell (Physical Location)\n• Create a Logger (Hardware Linkage)"]
Step2["Step 2: Hardware Setup\n• Connect USB-C or Battery Power\n• Wire Sensors (SDI-12, I2C, Analog V/I)"]
Step3["Step 3: Device Configuration\n• Connect to 'ents-XXXXXXXX' WiFi\n• Open 192.168.4.1 Captive Portal\n• Enter Logger ID, Cell ID, and Network Credentials"]
Step4["Step 4: Verification & Monitoring\n• Observe Status LED Sequences\n• View Live Stream on DirtViz Dashboard"]
Step1 --> Step2 --> Step3 --> Step4
Section Navigation¶
- DirtViz Web Platform: How to create accounts, set up virtual Cells, register hardware Loggers, view live streaming graphs, and download data as CSV.
- Hardware Setup and Wiring: Power supply options, screw terminal wiring diagrams for SDI-12 and analog measurements, and sensor pinouts.
- Captive Portal Configuration: Connecting to the onboard ESP32 SoftAP hotspot (
ents-XXXXXXXX), accessing the local webform athttp://192.168.4.1, and saving network parameters. - Diagnostics and LEDs: Understanding LED blink cadences, reset sequences, and reading diagnostic messages over the USB serial terminal.
Quick Reference¶
| Parameter | Default Value | Notes |
|---|---|---|
| Configuration WiFi SSID | ents-XXXXXXXX |
XXXXXXXX matches the board MAC address printed on the bottom silkscreen. |
| Configuration WiFi Password | ilovedirt |
Required to join the device captive hotspot. |
| Captive Portal URL | http://192.168.4.1 |
Accessible only while connected to the board's WiFi. |
| Power Requirements | 5V DC, >= 500mA | Via USB-C port, or 3.7V Li-ion battery on header J9. |
| Serial Console Baud Rate | 115200 baud (8N1) | Silicon Labs CP2102 USB-to-UART bridge. |
| Live Web Portal | dirtviz.jlab.ucsc.edu | Primary data access and dashboard portal. |