Frequently Asked Questions

TeHyBug is an advanced WiFi-enabled environmental monitoring device that tracks temperature, humidity, and atmospheric pressure. It periodically sends data to the TeHyBug cloud platform, your own web server, or MQTT broker, where you can view real-time and historical data through intuitive graphs and dashboards.

Perfect for monitoring:

• Server rooms and data centers
• Basements and storage areas
• Greenhouses and gardens
• Wine cellars and humidors
• Home automation systems

TeHyBug stands out with its unique features:

• Long Battery Life: Operates for months on a single battery charge
• WiFi Connectivity: Works anywhere your WiFi network reaches
• Multiple Sensors: Choose from DHT21, DHT22, BMP280, BME280, or DS18B20 sensors
• Flexible Data Options: Send data via HTTP or MQTT protocols
• Optional Display: Real-time readings on built-in OLED display
• Cloud & Self-Hosted: Use our cloud platform or host your own data server
• Deep Sleep Mode: Ultra-low power consumption between measurements

Getting started is easy:

1. Power on your TeHyBug device
2. Connect to the TeHyBug WiFi network (TeHyBug_xxxxx)
3. Open your browser and navigate to http://192.168.1.1/
4. Configure your WiFi credentials and data server settings
5. Save settings and restart the device
6. Register your device on tehybug.com or configure your own server
7. Start monitoring your environment!

Create Account View Configuration Guide

TeHyBug features a low dropout voltage regulator supporting:

• Input Voltage Range: 3.4V to 11V
• 9V Battery: Standard 9V battery connector included
• 18650 LiPo Cell: 3.7V rechargeable battery (recommended for long-term use)
• USB Power Supply: 5V USB adapter for continuous operation
• Solar Power: Compatible with solar charging circuits

For devices with displays, USB power supply is recommended due to higher power consumption.

Battery life depends on several factors:

Measurement Frequency

• Every 5 minutes: ~1-2 weeks (requires USB power)
• Every 15 minutes: ~1-2 months
• Every 30 minutes: ~3-6 months (recommended)
• Every hour: ~6-12 months

Battery Capacity

• 9V Battery: ~500mAh (1-2 months at 30min intervals)
• 18650 LiPo: ~2500-3500mAh (6+ months at 30min intervals)
• Multiple 18650: Extended operation time

Tips for Maximum Battery Life

• Set measurement frequency to 30 minutes or higher
• Use high-capacity batteries (18650 recommended)
• Disable display when not needed
• Ensure strong WiFi signal to reduce connection time
• Keep firmware updated for power optimizations

If your battery drains quickly, check these common issues:

While technically possible, it's not recommended:

• OLED displays consume significant power continuously
• Battery life reduced to days instead of months
• Display requires device to stay awake, preventing deep sleep

Recommendation: Use a USB power supply (5V, 1A minimum) for devices with displays. This ensures reliable operation and eliminates battery concerns.

TeHyBug supports two primary data transmission methods:

• HTTP GET Requests: Send data to a web server using URL parameters
• MQTT Protocol: Publish data to an MQTT broker for integration with IoT platforms

Both methods support various sensor data including temperature, humidity, and pressure readings.

No, you don't need programming knowledge. TeHyBug comes pre-flashed with firmware and is ready to use right out of the box. All configuration is done through a simple web interface accessible via your browser.

The device operates in two modes:

1. Configuration Mode: Device acts as a WiFi hotspot (TeHyBug_xxxxx). Connect to this network and visit http://192.168.1.1/ to access the configuration page
2. Live Mode: Device connects to your WiFi network and begins sending data

During configuration, you'll need to provide:

• Your WiFi network credentials
• Data server settings (TeHyBug.com cloud or custom HTTP/MQTT endpoint)
• Display configuration (if applicable)

Configuration Demo Video

To enter configuration mode:

1. Press and hold the BLACK reset button
2. Press the RED button briefly
3. The blue LED will light up solid, indicating configuration mode

Reset Demo Video

To return to live mode:

1. Press and hold the BLACK reset button
2. Press the RED button briefly
3. The blue LED will blink rapidly, indicating live mode

In live mode, the device will connect to your configured WiFi network and begin sending data to your chosen server or broker.

TeHyBug supports various placeholders for custom data URLs and MQTT messages:

HTTP Examples:
http://tehybug.com/track/?t=%temp%&h=%humi%&p=%qfe%&chipid=%chipid%&bug_key=%key%
http://tehybug.com/track/?t=%temp%&p=%qfe%&chipid=%chipid%&bug_key=%key%
http://tehybug.com/track/?t=%temp%&h=%humi%&chipid=%chipid%&bug_key=%key%
http://tehybug.com/track/?t=%temp%&chipid=%chipid%&bug_key=%key%

MQTT Examples:
{"t":"%temp%","h":"%humi%","p":"%qfe%","chip_id":"%chipid%","bug_key":"%key%"}
{"t":"%temp%","p":"%qfe%","chip_id":"%chipid%","bug_key":"%key%"}
{"t":"%temp%","h":"%humi%","chip_id":"%chipid%","bug_key":"%key%"}
{"t":"%temp%","chip_id":"%chipid%","bug_key":"%key%"}

TeHyBug offers several sensor options:

Data is displayed through interactive charts and dashboards on tehybug.com:

Features include:

• Real-time data visualization
• Historical data trends
• Customizable time ranges
• Export capabilities

To receive alerts via Telegram:

1. Add @tehybot to your contacts
2. Receive your chat ID from the bot
3. Enter your chat ID in your profile settings at tehybug.com

Configure notification settings to receive alerts when specific thresholds are met.

Send /help to the TeHyBug Telegram bot to see all available commands:

• /start - Begin interaction with the bot
• /status - Check current device status
• /data - Get latest sensor readings
• /help - Show all available commands

TeHyBug integrates with Blynk through:

1. Create virtual pins in your Blynk app (e.g., V0 for temperature, V1 for humidity)
2. Use our workaround script for submitting multiple values at once
3. Configure your TeHyBug with the following URL:

http://tehybug.com/blynk/auth_token/tokenvaluegoeshere/?pins=V0,V1&values=%temp%,%humi%

Replace tokenvaluegoeshere with your actual Blynk authentication token.