This program reads serial port communication from Enervent Pelican ACE ventilation machine and publishes the information to a MQTT broker.
dotnet build
dotnet run
The following settings can be configured in the appsettings.json file.
| Setting | Description |
|---|---|
| mqtt:broker | Hostname of the MQTT broker |
| mqtt:username | Username used to login to the MQTT broker |
| mqtt:password | MQTT broker password |
| serialPort | Name of the serial port to open, e.g. COM3 |
| homeAssistantAutoDiscovery | true if pelican2mqtt should automatically register sensors in Home Assistant |
You may also customize the topics used to report different registers.
Pelican2mqtt automatically registers the MQTT topics as entities in Home Assistant using the MQTT discovery mechanism. No manual configuration is needed. This is controlled by the homeAssistantAutoDiscovery setting which is enabled by default.
Pelican's sensors and settings are also grouped in Home Assistant as a "device".
-
Place the background image into HA's config/www directory.
-
Use the YAML in this file in your "picture elements" dashboard element.
Enervent Pelican ACE uses a RS-485 serial bus in communicating with remote display and control units. Pelican broadcasts internal settings and statuses through the bus and receives commands and settings from the control units.
The following image shows the information published to the MQTT broker.
Bit rate is 19200 bps, 8 data bits, no parity and one stop bit (8N1).
Messages in the protocol have the following frame format:
| Byte | Hex value | Description |
|---|---|---|
| STX | 0x80 | Start byte |
| SRC | 0x01 | Source address, always 1 |
| DST | 0x01 | Destination address, always 1 |
| LEN | Length of the message in bytes | |
| Data bytes | ||
| CRC | Simple checksum | |
| ETX | 0x81 | End byte |
| Command | Index | Description |
|---|---|---|
| E6 | 1 | Supply air temperature |
| 2 | Exhaust air temperature | |
| 3 | Waste air temperature | |
| 4 | Outside temperature | |
| 5 | Return water temperature | |
| 6 | Supply air temperature just after HRW, but before heating element. | |
| E7 | 1 | Supply air temperature preset value |
| 2 | Exhaust air temperature preset value | |
| 3 | Room temperature preset value | |
| 4 | Low limit for supply air temperature | |
| 5 | High limit for supply air temperature | |
| E8 | 1 | Supply fan normal speed setting |
| 2 | Exhaust fan normal speed setting | |
| 3 | Supply fan speed setting in timer program | |
| 4 | Exhaust fan speed setting in timer program | |
| 5 | Supply fan speed setting when overpressurizing | |
| 6 | Exhaust fan speed setting when overpressurizing |