c0r391/ha-tna-os-canaan

This is a custom integration for Home Assistant, the popular home automation platform, that lets it talk to Bitcoin mining hardware made by Canaan running firmware called TNA-OS-CANAAN, such as the Avalon Nano 3s and Avalon Q. It is an independent project not made or endorsed by the people behind that mining firmware. Once installed, it connects to a miner over the local network and pulls in a large set of live readings as Home Assistant sensors: hashrate over several time windows, power draw, temperatures, fan speed, voltage and current, pool connection status, WiFi and Ethernet signal quality, and uptime. It also exposes controls, letting a user adjust the ASIC frequency, core voltage, and fan speed from Home Assistant, plus buttons to reboot the miner or reset its hashboard, and a switch to turn the hashboard on or off entirely. The README is upfront that this is alpha quality software, tested live against one specific miner model and one firmware version, though it also follows the newer public API documentation for a later firmware release. It is installed either through HACS, the Home Assistant Community Store, as a custom repository, or by manually copying a folder into the Home Assistant configuration directory. There is a clear security warning: the mining firmware's API has no authentication at all, so anyone who can reach the miner on the local network can read its data or change its settings. The README strongly advises against exposing the miner or this integration to the public internet without extra protection like a VPN, since some of the exposed controls, like turning off the hashboard or rebooting the device, are meant to be treated as sensitive administrative actions. Some advanced and safety sensitive settings, such as editing mining pools or thermal limits, are deliberately left out of this version.