Honda Generator integration for Home Assistant

Unofficial Home Assistant integration for remote monitoring and control of Honda generators via Bluetooth Low Energy (BLE).

Features

• Automatic Discovery: Detects Honda generators via Bluetooth
• Real-time Monitoring: View generator diagnostics updated every 10 seconds (configurable)
• Engine Control: Start and stop the generator remotely via Home Assistant (model-dependent)
• ECO Mode Control: Toggle ECO mode on supported models
• Fuel Monitoring: View fuel level and remaining runtime on supported models
• Service Tracking: Track maintenance schedules based on runtime hours and calendar time
• Automatic Reconnection: Handles BLE connection drops gracefully
• Diagnostics Support: Download debug information for troubleshooting

Supported Devices and Features

Model	Remote Start	ECO Control	Fuel Sensor	Architecture
Honda EU2200i	-	-	-	Poll
Honda EU3200i	-	-	✅	Push
Honda EM5000SX	✅	✅	-	Poll
Honda EM6500SX	✅	✅	-	Poll
Honda EU7000is	✅	-	✅	Poll

Architecture Notes:

• Poll: Data is polled at configurable intervals (default: 10 seconds)
• Push: Data is streamed continuously in real-time via CAN bus

Installation

HACS (Recommended)

1. Open HACS in Home Assistant
2. Search for Honda Generator
3. Click Download
4. Restart Home Assistant

Manual Installation

1. Download the latest release from GitHub Releases
2. Extract and copy the honda_generator folder to your custom_components directory:

   cp -r honda_generator /config/custom_components/

3. Restart Home Assistant

Configuration

1. Ensure Bluetooth is enabled on your Home Assistant host
2. Power on your Honda generator within Bluetooth range
3. Go to Settings → Devices & Services
4. The generator should be auto-discovered, or click Add Integration and search for "Honda Generator"
5. Enter your generator's Bluetooth password (default: 00000000)

Options

After setup, you can configure:

• Scan Interval: How often to poll the generator (default: 10 seconds) - Poll architecture only
• Reconnect after consecutive failures: Force a Bluetooth reconnection after this many consecutive failed updates (0 to disable, 1-10 to enable)
• Startup grace period: Time in seconds to wait for generator discovery after Home Assistant restart before showing offline defaults (0 to disable)
• Stop command attempts: Number of times to send the stop command (1-30) - Poll architecture only

Note: EU3200i (Push architecture) streams data continuously, so scan interval and stop attempts do not apply.

Entities

Sensors

Entity	Description	Unit	Notes
Runtime Hours	Total engine runtime	hours	Includes usage_rate_hours_per_day attribute
Output Current	Current electrical output	A
Output Power	Apparent power output	VA
Output Voltage	Output voltage	V
Engine Event	Last engine event	-	Poll architecture only
Engine Error	Current error code	-	Poll architecture only
Fuel Level	Current fuel tank level	%	EU7000is, EU3200i
Fuel Remaining Time	Estimated runtime remaining	min	EU7000is, EU3200i
Fuel Gauge Level	Discrete fuel gauge level (0-17)	-	EU3200i only
Fuel Volume	Current fuel volume	mL	EU3200i only
Output Voltage Setting	Configured output voltage	V	EU3200i only

Binary Sensors

Entity	Description	Notes
ECO Mode	Whether ECO throttle mode is active	Read-only; excluded on models with ECO switch
Engine Running	Whether the engine is currently running
Warning/Fault Codes	Individual warning and fault flags	Disabled by default
Service Due	Whether a maintenance service is due	See Service Tracking; includes scheduling attributes

Buttons

Entity	Description	Notes
Stop Engine	Remotely stop the generator engine	All models
Start Engine	Remotely start the generator engine	EM5000SX, EM6500SX, EU7000is only
Mark Service Complete	Record that a maintenance service was performed	See Service Tracking

Switches

Entity	Description	Notes
ECO Mode	Toggle ECO throttle mode	EM5000SX, EM6500SX only

Services

Service	Description
honda_generator.stop_engine	Stop the generator engine (for use in automations)
honda_generator.set_service_record	Set the last service date and hours for a maintenance item
honda_generator.clear_discoveries	Clear pending discovery flows from the integration list

Device Info

• Model: Detected from serial number prefix (EU2200i, EU3200i, EM5000SX, EM6500SX, EU7000is, or Unknown)
• Serial Number: Generator serial number
• Firmware Version: Generator firmware version

Service Tracking

The integration tracks maintenance schedules based on both runtime hours and calendar time, similar to the official Honda app.

Tracked Services

Service	Enabled by Default	Notes
Oil Change	Yes	Uses break-in interval (20h/30d) until first change, then regular interval (100h/180d)
Air Filter Clean	No
Air Filter Replace	No	EU3200i only
Spark Plug Check	No
Spark Plug Replace	No
Spark Arrester Clean	No
Sediment Cup Clean	No	EM5000SX, EM6500SX, EU7000is only
Valve Clearance	No	Dealer service
Timing Belt	No	EU3200i only, dealer service
Combustion Chamber	No	Dealer service
Fuel Tank Clean	No	Dealer service
Fuel Pump Filter	No	EU3200i only, dealer service
Fuel System Check	No	Dealer service

Service intervals vary by model. See SERVICE_SCHEDULE.md for complete details.

How It Works

Each service has two entities:

• Binary Sensor (binary_sensor.*_service_due): Shows on when the service is due based on runtime hours OR calendar time (whichever threshold is reached first)
• Button (button.*_mark_service_complete): Press to record the service as complete at the current runtime hours and date

The service due binary sensor includes attributes for use in automations and dashboards:

Attribute	Description
estimated_date	Estimated date when service will be due, based on current usage rate
hours_remaining	Runtime hours remaining until service is due (negative = overdue)
days_remaining	Calendar days remaining until service is due by date (negative = overdue)
last_service_hours	Runtime hours at last service
last_service_date	Date of last service
interval_hours	Service interval in runtime hours
interval_days	Service interval in calendar days
service_type	Service type identifier
dealer_service	Present when the service requires a dealer

Recording and Importing Service History

To record a service you just performed, use the honda_generator.set_service_record service with just the device and service type — hours and date default to the current runtime hours and today:

service: honda_generator.set_service_record
data:
  device_id: <your_device_id>
  service_type: oil_change

To import historical service records (e.g., from the Honda app), specify hours and date explicitly:

service: honda_generator.set_service_record
data:
  device_id: <your_device_id>
  service_type: oil_change
  hours: 2049
  date: "2025-10-17"

Find your device ID in Settings → Devices & Services → Honda Generator → click on your device → the ID is in the URL.

Requirements

• Home Assistant 2024.1.0 or newer
• Bluetooth adapter or ESPHome Bluetooth Proxy
• Honda generator with Bluetooth module
• Generator within Bluetooth range (~30 feet / 10 meters)

Troubleshooting

Bluetooth Pairing

• Your Bluetooth adapter must be very close (~3 feet / 1 meter) during initial pairing
• You must discover and begin configuring your generator within ~30 seconds after engine startup
• Pairing occurs automatically during detection and configuration
• After pairing, Bluetooth operates at normal range

Generator Not Discovered

• Ensure the generator is powered on
• Verify Home Assistant has a working Bluetooth adapter or ESPHome proxy
• Move your Bluetooth device closer to the generator
• Check Home Assistant logs for Bluetooth errors

Connection Drops Frequently

• The integration automatically reconnects on the next poll cycle
• Consider adjusting the scan interval in options
• Minimize interference between the Bluetooth adapter and generator
• An ESPHome Bluetooth proxy near the generator improves reliability

Authentication Failed

• Verify you're using the correct Bluetooth password
• The default password is 00000000 (eight zeros)
• Try removing and re-adding the integration

Download Diagnostics

If you need help troubleshooting:

1. Go to Settings → Devices & Services → Honda Generator
2. Click the three dots menu → Download diagnostics
3. Attach the file when creating a GitHub issue

Development

Running Tests

python3 run_tests.py

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run the tests (python3 run_tests.py)
5. Submit a pull request

If you have a Honda generator model that isn't currently supported, please create an issue with your model information.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Disclaimer

This integration is not affiliated with or endorsed by Honda Motor Co., Ltd. Use at your own risk. Always follow proper safety procedures when operating generators.