![](\"https://github.com/homebridge/branding/blob/latest/logos/homebridge-wordmark-logo-horizontal.png\"){kind=logo}
\n\n\n
![\"Home\"](\"https://raw.githubusercontent.com/Sinclair81/Homebridge-Logo-Platform/master/Home.png\"){kind=logo}
\n\n\nUse a Siemens LOGO! PLC for switch on whatever you want. \nCommunicate with LOGO! over Snap7 or Modbus. \n\n__Type of Accessory:__\n\n- [Switch](#switch-configuration) \n- [Lightbulb](#lightbulb-configuration) \n- [Blind](#blind-configuration) \n- [Window](#window-configuration) \n- [Garage Door](#garage-door-configuration) \n- [Thermostat](#thermostat-configuration)\n- [Irrigation System](#irrigation-system-configuration)\n- [Valve](#valve-configuration)\n- [Fan](#fan-configuration)\n- [Filter Maintenance](#filter-maintenance-configuration)\n- [Outlet](#outlet-configuration) \n\n__Type of Sensor Accessory:__\n\n- [Light Sensor](#light-sensor-configuration)\n- [Motion Sensor](#motion-sensor-configuration)\n- [Contact Sensor](#contact-sensor-configuration)\n- [Smoke Sensor](#smoke-sensor-configuration)\n- [Temperature Sensor](#temperature-sensor-configuration)\n- [Humidity Sensor](#humidity-sensor-configuration)\n- [Carbon Dioxide Sensor](#carbon-dioxide-sensor-configuration)\n- [Air Quality Sensor](#air-quality-sensor-configuration)\n- [Leak Sensor](#leak-sensor-configuration)\n- [Watchdog](#watchdog-configuration)\n\n__Special Functions:__\n\n- [Logging to InfluxDB or Eve App](#logging-to-influxdb-or-eve-app)\n- [Multi Accessory](#other-configuration)\n\n__Examples:__\n\n- [Main Configuration](#main-configuration)\n\n## Installation ##\n\n1. Install homebridge using instruction from: [Homebridge WiKi](https://github.com/homebridge/homebridge/wiki)\n2. Install this plugin in your homebridge\n3. Update your configuration file with code like the sample below\n\n## Thanks to ##\n\n- [SoulL3Zz](https://github.com/SoulL3Zz) for:\n - Fix child bridge crash on ECONNRESET from LOGO! Modbus connection\n\n- [Tellicious](https://github.com/Tellicious) for: \n - Adding logging to the Eve app.\n - Integrated valve as sub-accessory of IrrigationSystem.\n - His Bugfix to avoid memory leak.\n\n## Special thanks to ## \n \n- Davide Nardella for [Snap7](http://snap7.sourceforge.net) \n- Fabio Riva for [Napi-Snap7](https://github.com/fabioriva/napi-snap7). And for allowing me to improve his plugin.\n- Mathias Küsel for [Node-Snap7](https://github.com/mathiask88/node-snap7) (was used until v1.3.8) \n\n## Known issues ## \n \n- The plugin cannot be configured with the Config UI. (The settings are too complex.) \n \n## Platform Main Configuration Parameters ##\n\nName | Value | Required | Notes\n----------------- | ------------------------- | ------------- | ------------------------\n`platform` | \"LogoPlatform\" | yes | Must be set to \"LogoPlatform\".\n`name` | (custom) | yes | Name of platform that will not appear in homekit app.\n`interface` | \"modbus\" or \"snap7\" | no | Interface for communication, default is: \"modbus\".\n`ip` | \"10.0.0.100\" | yes | Must be set to the IP of your LOGO!.\n`port` | 502 | no (ModBus) | Must be set to the Modbus Port of your LOGO!, default is: 502.\n`logoType` | \"0BA7\" or ... | no (Snap7) | Must be set to the [Type of your LOGO](#type-of-your-logo), default is: \"0BA7\".\n`localTSAP` | \"0x1200\" | no (Snap7) | Must be set to the local TSAP of your LOGO!, default is: \"0x1200\".\n`remoteTSAP` | \"0x2200\" | no (Snap7) | Must be set to the remote TSAP of your LOGO!, default is: \"0x2200\".\n`queueInterval` | 100 ... 1000 | no | Interval to send queries from Plugin to LOGO!, in milliseconds, default is: 100.\n`queueSize` | 100 ... 1000 | no | Number of items to be hold in send/receive queue, default is: 100.\n`updateInterval` | 0 ... ∞ | no | Auto Update Interval in milliseconds, 0 = Off\n`debugMsgLog` | 0 or 1 | no | Displays messages of all accessories in the log, default is: 0.\n`retryCount` | 0 ... ∞ | no | Retry count for sending the queries messages, default is: 5.\n`pushButton` | 0 or 1 | no | If e.g. the network input in the LOGO! a hardware button on the LOGO! simulated, default is: 0. (For all Accessories.)\n`loggerType` | \"influxDB\" or \"fakegato\" | no | Activates Logging, default is: \"none\". \n`loggerInterval` | 300000 | no | Logging Interval in milliseconds, default is: 300000 (5min)\n`influxDBUrl` | \"![\"other\"](\"https://raw.githubusercontent.com/Sinclair81/Homebridge-Logo-Platform/main/other-ventilation.png\"){kind=logo}
\n\n## Light Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n------------------- | ---------- | -------- | ---------- | ------------------------\n`light` | \"VW66\" | yes* | \"lightSensor\" | Light Sensor for Current Ambient Light Level in Lux\n\n```json\n{\n \"name\": \"Sensor-1\",\n \"type\": \"lightSensor\",\n \"light\": \"VW66\"\n}\n```\n\n## Motion Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n---------------- | ------------------- | -------- | ---------- | ------------------------\n`motion` | \"V8.0\" | yes* | \"motionSensor\" | Motion Sensor\n\n```json\n{\n \"name\": \"Sensor-2\",\n \"type\": \"motionSensor\",\n \"motion\": \"V8.0\"\n}\n```\n\n## Contact Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n---------------- | ------------------- | -------- | ---------- | ------------------------\n`contact` | \"V8.1\" | yes* | \"contactSensor\" | Contact Sensor\n\n```json\n{\n \"name\": \"Sensor-3\",\n \"type\": \"contactSensor\",\n \"contact\": \"V8.1\"\n}\n```\n\n## Smoke Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n---------------- | ------------------- | -------- | ---------- | ------------------------\n`smoke` | \"V8.2\" | yes* | \"smokeSensor\" | Smoke Sensor\n\n```json\n{\n \"name\": \"Sensor-4\",\n \"type\": \"smokeSensor\",\n \"smoke\": \"V8.2\"\n}\n```\n\n## Temperature Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n------------------------ | ------------------- | -------- | ---------- | ------------------------\n`temperature` | \"VW68\" | yes* | \"temperatureSensor\" | Temperature Sensor for Current Temperature in °C (-270°C - 100°C!!)\n`convertValue` | 0 or 1 | no* | \"temperatureSensor\" | Convert Int in Float, default is: 0. (235 / 10 == 23.5°C) \n\n```json\n{\n \"name\": \"Sensor-5\",\n \"type\": \"temperatureSensor\",\n \"convertValue\": 1,\n \"temperature\": \"VW68\"\n}\n```\n\n## Humidity Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n------------------------ | ------------------- | -------- | ---------- | ------------------------\n`humidity` | \"VW70\" | yes* | \"humiditySensor\" | Humidity Sensor for Current Relative Humidity in %\n`convertValue` | 0 or 1 | no* | \"humiditySensor\" | Convert Int in Float, default is: 0. (456 / 10 == 45.6%rH => 46%rH in Home App)\n\n```json\n{\n \"name\": \"Sensor-6\",\n \"type\": \"humiditySensor\",\n \"convertValue\": 1,\n \"humidity\": \"VW70\"\n}\n```\n\n## Carbon Dioxide Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n------------------------ | ------------------- | -------- | ---------- | ------------------------\n`carbonDioxide` | \"V9.0\" | yes* | \"carbonDioxideSensor\" | Carbon Dioxide\n`carbonDioxideLevel` | \"VW72\" | no* | \"carbonDioxideSensor\" | Carbon Dioxide Level in ppm\n`carbonDioxidePeakLevel` | \"VW74\" | no* | \"carbonDioxideSensor\" | Carbon Dioxide Peak Level in ppm\n\n```json\n{\n \"name\": \"Sensor-7\",\n \"type\": \"carbonDioxideSensor\",\n \"carbonDioxide\": \"V9.0\",\n \"carbonDioxideLevel\": \"VW72\",\n \"carbonDioxidePeakLevel\": \"VW74\"\n}\n```\n\n## Air Quality Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n------------------------ | ------------------- | -------- | ---------- | ------------------------\n`airQuality` | \"VW76\" | yes* | \"airQualitySensor\" | Air Quality (0 - 5)\n\n- 0 - Unknown \n- 1 - Excellent - CO2 < 800ppm (IDA 1) \n- 2 - Good - CO2 = 800 - 1000ppm (IDA 2) \n- 3 - Fair - CO2 = 1000 - 1400ppm (IDA 3) \n- 4 - Inferior - CO2 = 1400 - 1800ppm (IDA 4) \n- 5 - Poor - CO2 > 1800ppm \n\n```json\n{\n \"name\": \"Sensor-8\",\n \"type\": \"airQualitySensor\",\n \"airQuality\": \"VW76\"\n}\n```\n\n## Leak Sensor Configuration ##\n\nName | Value | Required | Option for | Notes\n---------------- | ------------------- | -------- | ---------- | ------------------------\n`leak` | \"V9.1\" | yes* | \"leakSensor\" | Leak Sensor\n`waterLevel` | \"VW78\" | no* | \"leakSensor\" | Water Level in %\n\n```json\n{\n \"name\": \"Sensor-9\",\n \"type\": \"leakSensor\",\n \"leak\": \"V9.1\",\n \"waterLevel\": \"VW78\"\n}\n```\n\n## Watchdog Configuration ##\n\nLOGO! Connection Watchdog, to check whether the correct values are still being read from the LOGO!.\nIn rare cases, a connection problem with Snap7 connections means that when querying value \"A\",\nall further queries produce the wrong results. The query for value \"B\" returns the result for querying value \"A\".\nThe query for value \"C\" returns the result for querying value \"B\".\nAnd so on.\n\nName | Value | Required | Option for | Notes\n---------------- | ------------------- | -------- | ---------- | ------------------------\n`watchdog` | \"VW79\" | yes* | \"watchdog\" | Watchdog - Qn, AQn, Mn, AMn, Vn.n, or VWn \n`expectedValue` | 1234 | yes* | \"watchdog\" | Expected Value - any number, e.g. 1234 \n`disconnect` | 0 or 1 | no* | \"watchdog\" | Disconnect automatically when errors are detected, default is: 0. \n\n```json\n{\n \"name\": \"LOGO Watchdog\",\n \"type\": \"watchdog\",\n \"watchdog\": \"VW79\",\n \"expectedValue\": 1234,\n \"disconnect\": 1\n}\n```\n \n## Logging to InfluxDB or Eve App ##\n\n| Type | Characteristic | InfluxDB | Eve App |\n|-----------------------|----------------------------------------------------------------------------------------------------|---------------------------------|----------------------------|\n| Switch | On | yes | yes |\n| Lightbulb | On