Skip to content

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
Figure 1: Four-phase deployment workflow for field operators, connecting physical setup to cloud telemetry.

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 at http://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.