TD22057/insteon-mqtt

Documentation Clarification for 2012-era Insteon Hubs

Closed this issue · 1 comments

Hello. I just wanted to let you know about a documentation issue that had me tearing my hair out for the last couple of days.

I have the older Insteon Hub (2012), model 2242-222, that supports the direct serial commands to port 9761.

I kept following the instructions for the newer Insteon Hub (model 2245-222), but it refused to work. I looked though the Issues, and found a reference to someone else getting it working, but there was no documentation showing the proper configuration. I finally started digging through old commits and configurations that other people had posted on the Internet until I found a reference to using the "socket://:9761" in the port configuration.

Once I put that in the port section and ignored all the Insteon Hub configuration, it worked perfectly.

I did a quick search to see if there is any documentation referencing this, but a quick search failed to turn up anything.

I'd like to suggest a little blurb be added to "docs/hub.md" noting that if the user is trying to use the older Insteon Hub (2012), that they should just modify the port entry and ignore all the Insteon Hub.

Something like:

Note: If you're using the older Insteon Hub (2012), which has the model number 2242-222 for the US model, you do not need need to do the newer network hub configuration. This Hub supports direct serial commands, and does not need a username or password for Insteon-MQTT to connect to it. Simply put "socket://[IP ADDRESS]:9761" for the modem port in your config.yaml, where [IP ADDRESS] is the IP of the Insteon Hub, and Insteon-MQTT should be able to communicate with the Hub without any issues. I suggest assigning a static IP to the Hub so it will stay the same.

I apologize for the lack of Markdown, I haven't had a chance to sit down and properly learn it.

Thank you for a wonderful project! I'm migrating from MisterHouse to HomeAssistant, and I was missing the management capabilities that MisterHouse has for Insteon. This is the only project that I found that is able to do just about everything that MisterHouse can do, while using a system-agnostic protocol (MQTT).

Awesome, I didn't know there were older devices that had such support. I will add this info the the documents. Thanks.