This F.A.Q. covers the latest TeHyBug firmware and features. For legacy devices, some features may vary.

Frequently Asked Questions

TeHyBug is an IoT environmental monitoring system that tracks temperature, humidity, pressure, and other sensor data. It consists of ESP8266/ESP8285-based hardware devices and a cloud platform for data visualization and management.

Key features include:

  • Real-time environmental monitoring
  • WiFi connectivity
  • Multiple sensor support
  • Cloud data storage and visualization
  • Low power consumption with deep sleep mode
  • Easy OTA (Over-The-Air) firmware updates

The latest TeHyBug firmware is a complete rewrite in C/C++ (previous versions were partially written in Lua).

Key Features:
  • Fully written in C/C++ for better performance
  • Easy OTA (Over-The-Air) updates via web interface
  • Enhanced stability and reliability
  • Improved power management

The firmware is compatible with TeHyBug Universal boards (without display):

  • TeHyBug 18650 Universal v1 (ESP-01 based)
  • TeHyBug 18650 Universal v2 (ESP-M based)
  • Mini TeHyBug
  • Gumboard
  • Other TeHyBug boards with audio jack connector for sensors
Note: The firmware also works with generic ESP8266/ESP8285 dev boards (Wemos, Lolin, NodeMCU, etc.), but the indicator LED and deep sleep power saving mode may not function properly.

TeHyBug has two buttons:

  • RESET Button: Forces TeHyBug to reboot/restart
  • MODE Button: Activates configuration mode after reset during device boot

Live Mode

Device is configured to serve data (via HTTP/MQTT) with power-saving deep sleep enabled and config mode deactivated in system settings.

  • LED blinks rapidly
  • Device sends data at configured intervals
  • Enters deep sleep between measurements
Config Mode

TeHyBug serves a web interface at http://tehybug.local where you can configure everything.

  • LED is solid blue
  • Device acts as configuration portal
  • All settings can be modified
To return to Config mode from Live mode:
  1. Press the RESET button
  2. Push and hold the MODE button until LED turns blue
  3. Release the MODE button

Port B (green audio jack) supports the following sensors:

  • BME680 - Temperature, humidity, pressure, and gas sensor
  • BME280/BMP280 - Temperature, humidity, and pressure sensor
  • DHT21/DHT22/AM2032 - Temperature and humidity (in DHT simulation mode)
  • AHT20 - Temperature and humidity sensor
  • MAX44009 - Ambient light sensor
  • DS18B20 - Digital temperature sensor
  • Other I2C and OneWire sensors (requires code modification)

Pin Mapping: See the Port B pinmapping documentation for detailed connection information.

Port A (black audio jack) supports the following sensors:

  • DHT21/DHT22/AM2032 - Temperature and humidity (in DHT simulation mode)
  • DS18B20 - Digital temperature sensor
  • ADC Soil Moisture Sensor - Analog soil moisture measurement
  • Other ADC and OneWire sensors (requires code modification)

Pin Mapping: See the Port A pinmapping documentation for detailed connection information.

Configuration First Steps:
  1. Connect an external sensor to the board's 3.5mm audio jack connector
  2. Connect power supply to micro USB port
  3. TeHyBug will boot with solid blue LED
  4. Connect to TeHyBug WiFi network (Password: TeHyBug123)
  5. Open http://192.168.4.1/ in your browser and click configuration button
  6. Provide your WiFi network credentials and save
  7. TeHyBug will connect to your network and boot in configuration mode
  8. Open http://tehybug.local/ in your browser
  9. Follow the instructions on the configuration page
If http://tehybug.local/ doesn't work, find the device IP from your router and use that instead.

Demo Configuration Page: View Demo

You can update the firmware using the built-in OTA (Over-The-Air) feature:

  1. Connect to your TeHyBug device's configuration portal
  2. Navigate to the "Firmware Update" section
  3. Select the firmware file (.bin) you want to flash
  4. Click "Update Firmware"
  5. Wait for the update process to complete (device will reboot automatically)
Make sure your device is connected to power during the update process to avoid corruption.