{"id":44154231,"url":"https://github.com/8none1/hilighting_homeassistant","last_synced_at":"2026-02-09T04:47:33.253Z","repository":{"id":224389583,"uuid":"763134415","full_name":"8none1/hilighting_homeassistant","owner":"8none1","description":"Support for HiLighting LED strips in Home Assistant","archived":false,"fork":false,"pushed_at":"2025-01-01T16:18:38.000Z","size":2545,"stargazers_count":16,"open_issues_count":1,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-10-10T10:25:08.156Z","etag":null,"topics":["ble","home-assistant","homeassistant","led"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/8none1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-02-25T16:44:31.000Z","updated_at":"2025-09-16T22:36:17.000Z","dependencies_parsed_at":"2024-03-23T11:20:45.387Z","dependency_job_id":null,"html_url":"https://github.com/8none1/hilighting_homeassistant","commit_stats":null,"previous_names":["8none1/hilighting_homeassistant"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/8none1/hilighting_homeassistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fhilighting_homeassistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fhilighting_homeassistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fhilighting_homeassistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fhilighting_homeassistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/8none1","download_url":"https://codeload.github.com/8none1/hilighting_homeassistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8none1%2Fhilighting_homeassistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29256799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T04:11:57.159Z","status":"ssl_error","status_checked_at":"2026-02-09T04:11:56.117Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ble","home-assistant","homeassistant","led"],"created_at":"2026-02-09T04:47:30.478Z","updated_at":"2026-02-09T04:47:33.248Z","avatar_url":"https://github.com/8none1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HiLighting LEDs\n\nIt's yet another cheapo LED strip from AliExpress!  Every strip I buy seems to get cheaper and cheaper.  I find it strange that every manufacturer seems to implement their own controller and so each set of lights has a different protocol.  But here we are.\nThis time I paid £2.52 including tax and delivery for a 5M strip with an IR remote control.  The remote didn't include a battery.  The app is called `HiLighting`.  It forces you to enable precise location on Android before it will even detect your lights and allow you to control them!  There is some interesting looking functionality which allows you to choose your own colour scheme for the effects.  I don't think I will spent too much time with that since it's not supported in Home Assistant, but we'll see.\n\nSomething to be aware of is that the picture on the AliExpress page for the product doesn't necessarily represent the app or the controller that the lights will use.\n\nAliExpress link:  https://s.click.aliexpress.com/e/_DD74ZBn\n\n![image](https://github.com/8none1/hilighting_homeassistant/assets/6552931/317cab8a-c576-4db9-8aa8-8744dd775748)\n\n![image](https://github.com/8none1/hilighting_homeassistant/assets/6552931/5bb03ae0-b6ba-47ea-b27e-1a9519bb7eb1)\n\nMy lights report their name as: `L7161` and have a MAC address of `23:01:02:aa:10:84`.\n\n\n## Current State\n\nPlanned implementation complete.\n\nWorking:\n\n- On / Off\n- Set RGB colour\n- Brightness\n- Limited effects with variable speed\n\n## Installation in Home Assistant\n\n## Installation\n\n### Requirements\n\nYou need to have the bluetooth component configured and working in Home Assistant in order to use this integration.\n\n### HACS\n\nAdd this repo to HACS as a custom repo.  Click through:\n\n- HACS -\u003e Integrations -\u003e Top right menu -\u003e Custom Repositories\n- Paste the Github URL to this repo in to the Repository box\n- Choose category `Integration`\n- Click Add\n- Restart Home Assistant\n- HiLighting LED devices should start to appear in your Integrations page\n\n## Sniffing\n\nAs with the [ELK-BLEDOB](https://github.com/8none1/elk-bledob) project I will be using an nRF52840 BLE Sniffer rather than trying to get snoop logs off Android.\nSo let's breakout Wireshark and go fishing...\n\nTips if you're using Wireshark and a nRF52840 with the Nordic toolkit:\n\n- Filter `btle.length != 0` will hide empty PDU packets\n- Filter `btatt.handle == 0x0014` will show writes to the serial port\n\n## What the....\n\nIt looks like this set of lights offers a serial port over Bluetooth LE and then you send commands to it that way.\nHad a chat on the Home Assistant Discord and the feeling is that if it's GATT then it should just work, so I'm going to try and implement a simple on/off integration before digging in to all the complex stuff.\n... and ...  it does indeed just work.\n\n## Power on \u0026 off\n\nIf you have a BLE UART connection you just write these bytes to the serial port.  Using an app like [LightBlue](https://punchthrough.com/lightblue/) you can connect to the controller, connect to `6e400002-b5a3-f393-e0a9-e50e24dcca9e` and write these hex bytes.\n\n- `55 01 02 00` Off\n- `55 01 02 01` On\n\n## RGB\n\n```\n|------|------------------------ header\n|      | ||--------------------- red\n|      | || ||------------------ green\n|      | || || ||--------------- blue\n55 07 01 ff 00 00\n55 07 01 00 ff 00\n55 07 01 00 00 ff\n```\n## Brightness\n\nBrightness is odd.\n\n```\n|------|------------------------ header\n|      | |---|------------------ brightness\n55 03 01 09 03\n55 03 01 6c 02\n55 03 01 6f 05\n```\n\nMinimum brightness is 0x6c 0x02 (27650)\nMaximum brightness is 0xff 0x0f (65295)\n\nIt seems that the two brightness bytes do not represent a single value.  Byte 4, the last byte, is a scale which stops at 0x0F.  Byte 3 is the smaller increments which seems to be an 8 bit number.  I don't think it's really necessary to have that level of granularity on these type of LEDs, so I've only implemented the 15 levels of brightness from byte 4.  This seems fine.\n\n## Effects\n\nThe standard effects numbered from 0 to 9.  You don't seem to be able to specify a brightness for them.\n\n```\n|---|--------------------------- header\n|   | ||------------------------ select effect\n|   | || ||--------------------- effect number\n55 04 01 00\n55 04 01 01\n55 04 01 06\n55 04 01 07\n```\n\n### Effect Speed\n\n```\n|---|--------------------------- header\n|   | ||------------------------ select effect speed\n|   | || ||--------------------- speed (0-255)\n55 04 04 31\n55 04 04 59\n55 04 04 96\n55 04 04 bf\n55 04 04 ff\n```\n\n#### Custom Effects\n\nWe could build a set of custom effects and hard code them as part of the integration.  But I'm not planning on doing that any time soon.  The format seems easy enough to understand.\n\n\n```\n\n|------| --------------------------------------------------------------------- custom effects header\n|      | ||------------------------------------------------------------------- speed probably 0-255\n|      | || ||---------------------------------------------------------------- effect type (merge, flash etc) probably 1 -\u003e 5\n|      | || || ||------------------------------------------------------------- brightness probably 0-255\n|      | || || || |---------------| ------------------------------------------ likely all colour data. 2 bytes per colour? 565?\n55 05 01 00 03 00 fa f8 55 f9 b1 ff       -  RGB   merge,  slow,   dim\n55 05 01 00 03 ff fa f8 55 f9 b1 ff       -  RGB   merge,  slow,   bright\n55 05 01 7f 03 00 fa f8 55 f9 b1 ff       -  rgb   merge,  fast,   dim\n55 05 01 7f 03 ff fa f8 55 f9 b1 ff       -  rgb   merge,  fast,   bright\n55 05 01 7f 04 ff fa f8 55 f9 b1 ff       -  rgb   flash,  fast,   bright\n55 05 01 7f 05 ff fa f8 55 f9 b1 ff       -  rgb,  jump,   fast,   bright\n55 05 01 7f 05 ff fa f8 41 f9 fc fd 4d e4 -  rgrg, jump,   fast,   bright\n\n```\n\n## Other projects that might be of interest\n\n- [iDotMatrix](https://github.com/8none1/idotmatrix)\n- [Zengge LEDnet WF](https://github.com/8none1/zengge_lednetwf)\n- [iDealLED](https://github.com/8none1/idealLED)\n- [BJ_LED](https://github.com/8none1/bj_led)\n- [ELK BLEDOB](https://github.com/8none1/elk-bledob)\n- [HiLighting LED](https://github.com/8none1/hilighting_homeassistant)\n- [BLELED LED Lamp](https://github.com/8none1/ledble-ledlamp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8none1%2Fhilighting_homeassistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F8none1%2Fhilighting_homeassistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8none1%2Fhilighting_homeassistant/lists"}