homebridge-proflame/README.md

Homebridge plugin for Proflame fireplaces (Single Accessory) with all features including lamp control

# Homebridge Proflame

Homebridge Proflame is a single-accessory Homebridge plugin for Proflame Connect fireplaces. This plugin connects to your Proflame Wi-Fi dongle over a persistent WebSocket (port 88) and exposes full control via HomeKit.

## Features

- **Main On/Off**: Toggle the fireplace on/off (main_mode 1 for manual on, 0 for off).
- **Pilot Mode**: Separate switch for pilot control.
- **Fan Control**: Control fan speed with 6 discrete levels (0–6; 0 is off).
- **Split Flow**: Toggle split flow for secondary burners.
- **Auxiliary Output**: Toggle an extra output (e.g., extra fan or light).
- **Flame Control**: Adjust flame level with 6 levels (0–6; 0 is off).
- **Thermostat**: Set target temperature (stored as tenths of °C) and view current room temperature.
- **Lamp Control**: Control an ambient lamp or accent light with 6 levels (0–6; 0 is off).

The plugin sends a keep-alive ping (`PROFLAMEPING`) every 30 seconds and reconnects automatically if the connection closes. Connection events (open, close, reconnect) are logged only on the first connection; subsequent connection events are logged at the debug level.

## Config

{
  "accessories": [
    {
      "accessory": "ProflameFireplace",
      "name": "My Fireplace",
      "ip": "192.168.1.252",
      "pilotEnabled": true,
      "fanEnabled": true,
      "splitFlowEnabled": true,
      "auxEnabled": true,
      "flameControlEnabled": true,
      "thermostatEnabled": true,
      "lampEnabled": true
    }
  ]
}