[BETA] ESPHome: Apollo Automation TEMP-1B Driver

This driver connects your Apollo Automation TEMP-1B sensor directly to your HE hub thanks to the great work done by Jonathan Bradshaw (@jonathanb) - the ESPHome Hubitat Toolkit.

The driver can be installed using the community Hubitat Package Manager app or manually as a Bundle archive from GitHub.

  • :no_entry_sign: No Home Assistant Needed: Direct WiFi connection to your Hubitat hub

  • :no_entry_sign: No YAML Files to Edit: Simple IP address configuration - that's it!

  • :no_entry_sign: No Cloud Dependencies: Everything runs locally on your network

  • :zap: Easy Setup: Install this driver package from HPM (Hubitat Package Manager), connect the device to your WiFi network, configure the IP address in the driver - done.

  • :wrench: Zero Configuration: All device features work out-of-the-box

  • :house: Native Hubitat Integration: Full support for Hubitat automations, dashboards, and apps


Technical Specifications (click to expand)
  • Microcontroller: ESP32 with WiFi and Bluetooth

  • Power: USB 5V or CR123A or 16340 rechargeable battery

  • Battery Life: Up to 6 months with optimized sleep settings

  • Temperature Accuracy: ±0.5°C (probes), ±2°C (onboard sensor)

  • Humidity Accuracy: ±2% RH

  • Operating Range: -40°C to +85°C (-40°F to +185°F)

  • Connectivity: WiFi 802.11 b/g/n, Bluetooth 4.2

  • Dimensions: Compact 3D-printed enclosure

  • Mounting: Optional magnetic mount available

Use Cases (click to expand)

The Apollo Automation TEMP-1B is ideal for:

  • Kitchen Monitoring: Food temperature during cooking and baking

  • Refrigeration: Freezer and refrigerator temperature monitoring

  • Aquarium Management: Water temperature monitoring

  • Pool/Spa Monitoring: Water temperature tracking

  • Greenhouse Monitoring: Air and soil temperature monitoring

  • HVAC Monitoring: Room temperature and humidity tracking

  • Server Room Monitoring: Environmental condition monitoring

Apollo Automation TEMP-1B

TEMP-1B Main Device Apollo TMP-1(B) Features:
• ESP32-based platform with WiFi and Bluetooth connectivity
• Battery-powered operation (CR123A or 16340 rechargeable battery)
• Temperature Range: -40°C to +85°C (-40°F to +185°F)
• Humidity Range: 0-100% RH with ±2% accuracy
• Onboard AHT20-F temperature and humidity sensor
• RGB LED indicator with customizable colors
• Buzzer for temperature alerts
• 3.5mm jack for external probes
• Up to 6 months battery life with sleep mode
Temperature Probe Features:
• DS18B20 waterproof temperature sensor
• Available in 20cm (~8in) and 1.5m (~5ft) lengths
• Flat cable design prevents interference with fridge seals
• Submersible and waterproof construction
• Temperature Range: -55°C to +85°C (-67°F to +185°F)
• ±0.5°C accuracy
• Ideal for freezer, fridge, aquarium, and pool monitoring
Temperature Probe
Food Probe Food Probe Features:
• 1m (~3ft) stainless steel food-safe probe
• NTC temperature sensor
• Temperature Range: -40°C to +204°C (-40°F to +400°F)
• Food-safe stainless steel construction
• Perfect for grilling, baking, and cooking
• Not dishwasher safe
• Real-time temperature monitoring for perfect cooking results

Apollo Automation is a local tech startup building advanced hardware and software in Lexington, KY.

Made for ESPHome

:sparkles:Apollo Automation devices come pre-flashed with ESPHome firmware - just connect your TEMP-1B to your WiFi network and add the device IP address in the Preferences tab of this driver. No additional software, bridges, or complex configurations required.

Driver Description

Major Attributes

The Apollo Automation TEMP-1B driver provides comprehensive monitoring and control capabilities with a dozen of available attributes. For everyday use, the driver displays only the essential attributes by default, keeping your device interface clean and focused. Advanced users can enable additional diagnostic attributes through the preferences when needed.

Current States

Main Attributes

  • temperature: Primary temperature reading based on selected probe preference
  • humidity: Relative humidity from onboard AHT20-F sensor (0-100% RH)
  • networkStatus: Connection status ['connecting', 'online', 'offline']
  • rgbLight: RGB LED control ['on', 'off']

Advanced Attributes

These advanced attributes, disabled by default, provide additional insights and control for power users seeking enhanced functionality.

Complete Attribute List (click to expand)
Attribute Type Description
temperature number Primary temperature reading (°C/°F)
humidity number Relative humidity percentage
networkStatus enum Device connection status
rgbLight enum RGB LED control
battery number Battery charge level (0-100%)
batteryVoltage number Battery voltage measurement
boardTemperature number Internal board temperature
boardTemperatureOffset number Board temperature calibration offset
boardHumidityOffset number Board humidity calibration offset
espTemperature number ESP32 chip temperature
temperatureProbe number External temperature probe reading
tempProbeOffset number Temperature probe calibration offset
foodProbe number Food probe temperature reading
foodProbeOffset number Food probe calibration offset
uptime string Device uptime since last restart
rssi number WiFi signal strength (dBm)
alarmOutsideTempRange enum Temperature range alarm status
notifyOnlyOutsideTempDifference enum Temperature difference notification
preventSleep enum Sleep prevention control
selectedProbe string Active temperature probe selection
sleepDuration number Sleep duration in hours
probeTempDifferenceThreshold number Temperature difference threshold
minProbeTemp number Minimum probe temperature threshold
maxProbeTemp number Maximum probe temperature threshold

Advanced Attributes


Commands

Commands

initialize()

  • Establishes connection to the device and starts monitoring. Automatically called during device setup or manually from device commands.

refresh()

  • Refreshes device information and clears cached data. Manually refresh device status and request updated information from the device.

setRgbLight()

  • Purpose: Control the RGB LED indicator
  • Parameters: value: LED state ['off', 'on']
  • Usage: setRgbLight('on') or setRgbLight('off')

Preferences

Preferences

Basic Settings

Setting Default Description
logEnable false Enable debug logging for troubleshooting
txtEnable true Enable descriptive text logging
ipAddress (required) Device IP address for ESPHome API connection
selectedProbe 'Temperature' Select primary temperature sensor ['Temperature', 'Food']
boardHumidityOffset 0.0 Board humidity calibration offset (-50% to +50%)

Advanced Options

Setting Default Description
password (optional) Device password if required
diagnosticsReporting false Enable reporting of diagnostic attributes
logWarnEnable true Enable warning and info logging

More info on this driver

Driver Features & Technical Details (click to expand)

The driver is a work in progress. uses an intelligent entity management system that:

  • Automatically discovers all available ESPHome entities

  • Maps entities to appropriate Hubitat attributes

  • Handles missing entities gracefully (device variants may not have all sensors)

  • Provides diagnostic control - technical attributes can be hidden from main device view

  • Supports calibration - offset values sync between Hubitat preferences and ESPHome

Temperature Handling

The driver provides flexible temperature management:

  • Dual Temperature Sources: Choose between Temperature Probe and Food Probe

  • Automatic Unit Conversion: Converts between Celsius and Fahrenheit based on hub settings

  • Calibration Support: Individual offset adjustments for each temperature sensor

  • Sleep Mode Compatibility: Optimized for battery-powered operation with sleep cycles

Battery Management

For battery-powered TEMP-1B devices:

  • Battery Level Monitoring: Real-time battery percentage

  • Voltage Monitoring: Actual battery voltage for detailed analysis

  • Sleep Mode Support: Configurable sleep duration to extend battery life

  • Prevent Sleep Option: Keep device awake for continuous monitoring when needed

Network Monitoring

  • Connection Status: Real-time online/offline status

  • Signal Strength: WiFi RSSI monitoring

  • Automatic Reconnection: Built-in ESPHome API reconnection logic

Diagnostic Features

When diagnostic reporting is enabled:

  • ESP32 Monitoring: Internal chip temperature and performance

  • Uptime Tracking: Device restart and reliability monitoring

  • Configuration Access: View the advanced device settings

  • Calibration Values: View all sensor offset parameters

Alert System

The device supports customizable alerts:

  • Temperature Range Alarms: Configurable min/max temperature thresholds (not implemented in this driver)

  • Visual Indicators: RGB LED with customizable colors (only on/off is implemented in the driver)

  • Audible Alerts: Onboard buzzer for critical notifications (not tested)

  • Notification Controls: Flexible alert configuration options (not implemented in the driver and not tested)

Temperature Monitoring Graph

(Generated using the HE inbuilt webCoRE Graphs).


9 Likes

Reserved