{"id":20191279,"url":"https://github.com/paulannekov/home-assistant-padavan-tracker","last_synced_at":"2025-04-10T09:38:00.018Z","repository":{"id":20688897,"uuid":"85400693","full_name":"PaulAnnekov/home-assistant-padavan-tracker","owner":"PaulAnnekov","description":"Device tracker component that uses Padavan-based router","archived":false,"fork":false,"pushed_at":"2022-05-18T17:01:17.000Z","size":21,"stargazers_count":47,"open_issues_count":2,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-24T08:22:47.097Z","etag":null,"topics":["home-assistant","padavan","router","xiaomi"],"latest_commit_sha":null,"homepage":null,"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/PaulAnnekov.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}},"created_at":"2017-03-18T12:48:32.000Z","updated_at":"2024-12-14T10:53:57.000Z","dependencies_parsed_at":"2022-09-05T16:11:33.812Z","dependency_job_id":null,"html_url":"https://github.com/PaulAnnekov/home-assistant-padavan-tracker","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulAnnekov%2Fhome-assistant-padavan-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulAnnekov%2Fhome-assistant-padavan-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulAnnekov%2Fhome-assistant-padavan-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PaulAnnekov%2Fhome-assistant-padavan-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PaulAnnekov","download_url":"https://codeload.github.com/PaulAnnekov/home-assistant-padavan-tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248192693,"owners_count":21062727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["home-assistant","padavan","router","xiaomi"],"created_at":"2024-11-14T03:48:15.121Z","updated_at":"2025-04-10T09:37:59.989Z","avatar_url":"https://github.com/PaulAnnekov.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Home Assistant Padavan Device Tracker\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/hacs/integration)\n\nThis device tracker component allows you to get **wireless** devices presence from \n[Padavan](https://bitbucket.org/padavan/rt-n56u)-based routers.\n\nDevices support:\n- tested on Xiaomi MiWiFi Mini Router with Padavan 3.4.3.9-099_195eba6\n- [reported](https://github.com/PaulAnnekov/home-assistant-padavan-tracker/issues/11) working on Asus N56U Router with Padavan 3.4.3.9-099\n\nProbably need additional changes to make it work on other devices.\n\nPurpose\n-------\n\nDetect ANY Wi-Fi clients (=Android/iOS/Windows Phone smartphones...) with 100% accuracy at any time moment.\n\nWhy not ...?\n------------\n  \n  - [Nmap](https://home-assistant.io/components/device_tracker.nmap_tracker/) - mobile devices (Nexus 5X, iPhones) can\n    go to a deep sleep so nmap can send dozen different packages and get nothing. It's very unreliable. You need at \n    least 3 minutes to understand client is really offline and not ignoring your requests.\n  - [OpenWrt luci](https://home-assistant.io/components/device_tracker.luci/) - can't check, but from [source code](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/device_tracker/luci.py#L101)\n    it checks ARP table which is totally wrong, because it doesn't remove client immediately after disconnect.\n  - [OpenWrt ubus](https://home-assistant.io/components/device_tracker.ubus/) - looks promising, but doesn't exist in\n    Padavan firmware out of the box.\n  - [Xiaomi](https://home-assistant.io/components/device_tracker.xiaomi/) - works like this solution (=perfectly), \n    but only in _router_ mode. Padavan tracker works in AP mode too.\n\nInstallation (Xiaomi MiWiFi Mini Router only)\n------------------------------------------\n\n1. Download stock Xiaomi dev firmware http://www1.miwifi.com/miwifi_download.html.\n2. Flash it via web interface.\n3. Install Android app ([ru](https://4pda.ru/forum/index.php?showtopic=661224), \n[en](http://xiaomi.eu/community/threads/xiaomi-router-app-translation.25386/page-3#post-262621)).\n4. Attach router to your Mi account.\n5. Download ssh unlock firmware http://d.miwifi.com/rom/ssh, remember login/pass - it's ssh credentials.\n6. Put it on USB FAT32 stick:\n   1. Turn on Router while reset-button pressed and USB stick plugged in\n   2. Release Reset-button after the orange LED starts flashing\n   3. Wait a minute to complete flashing and device is online again (shown by blue LED)\n7. Check SSH to your device.\n8. Go to http://prometheus.freize.net/index.html:\n   1. Download utility.\n   2. Build Toolchain.\n   3. Build Firmware.\n   4. Flash Firmware.\n   5. Flash EEPROM.\n9. Add the following lines to the `configuration.yaml`:\n   \n  ```yaml\n  device_tracker:\n    - platform: padavan_tracker\n      consider_home: 10\n      interval_seconds: 3\n      url: http://192.168.1.1/ # web interface url (don't forget about `/` in the end)\n      username: admin # Web interface user name\n      password: admin # Web interface user pass\n  ```  \n\nNotes\n-----\n\n- Sometimes/most of the time web interface will be inaccessible while this component is working. That's because Padavan firmware doesn't allow \u003e1 users authorized from different IPs. Check the possible [workaround](https://github.com/PaulAnnekov/home-assistant-padavan-tracker/issues/8) for this.\n\n\nUseful links\n-------------\n \n - Firmware sources: https://bitbucket.org/padavan/rt-n56u\n - Firmware build and installation utility: http://prometheus.freize.net/index.html\n - OpenWrt wiki related to Xiaomi MiWiFi Mini: https://wiki.openwrt.org/toh/xiaomi/mini\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulannekov%2Fhome-assistant-padavan-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulannekov%2Fhome-assistant-padavan-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulannekov%2Fhome-assistant-padavan-tracker/lists"}