/homeassistant-recteq

Recteq Integration for Home Assistant

Primary LanguagePythonMIT LicenseMIT

Home Assistant Recteq Integration

recteq

NOTE - This isn't supported or approved by recteq at all!

This is a Home Assistant custom component for recteq grills and smokers. It supports connecting to multiple grills creating a climate entity and a couple sensor entities (probe A and B) for each one.

climate

entities

Installation

Download a copy of the latest release and unpack the contents into into config/custom_components/recteq/ on your HA machine then restart it.

Configuration

This integration is configured using the UI only. Navigate to Configuration > Integrations and tap the red "+" button in the bottom right. Search for and select the "Rectec" entry. You'll get the dialog shown below. Enter the details for your grill and tap "Submit".

config

IP Address, Device ID & Local Key

The IP address if your grill can usually be found if you dig into the logs for your DHCP server. Poke around on your router for that.

The tuyapower project can be used to scan for Tuya devices on your network. The controller in the rectecs is a Tuya device. The IP address is shows (10.0.0.100 below) is the one you want. The ID value in the output is the 20-digit device ID needed. The product value in the output is not the local key!

# python -m tuyapower
TuyaPower (Tuya compatible smart plug scanner) [0.0.25] tinytuya [1.0.3]

Scanning on UDP ports 6666 and 6667 for devices (15 retries)...

FOUND Device [Valid payload]: 10.0.0.100
    ID = 00000000000000000000, product = XXXXXXXXXXXXXXXX, Version = 3.3
    Device Key required to poll for stats

Scan Complete!  Found 1 devices.

tuyapower has some notes on how to get the local key but I found it on my Android phone pretty simply. I connect it via USB to my laptop, allow MTP access, then I can browse the filesystem on the phone. I found Phone/Android/data/com.ym.rectecgrill/cache/1.abj has logs from the app and includes JSON-formatted messages that include a localKey property. That's the 16-digit local key value needed here.

License

Copyright (c) 2020 Paul Dugas

See LICENSE for details.

Support

Submit issues for defects, feature requests or questions. I'll try to help as I can.

Credits

I'm Paul Dugas, paul@dugas.cc. This is my first HA integration so be gentle!

I learned this was possible from SDNick484/rectec_status and based the intial versions of the project on his examples.