KO
|
EN
gitlite — search
Search
#javascript
#python
#machine-learning
#react
#hacktoberfest
#java
#home-assistant
#mysql
#php
#typescript
#data-science
#cpp
mihome-binary-protocol
★ 741
Open GitHub ↗
No description available.
Download README (.md)
Explore Similar Repositories
Hacktoberfest-2020
:
:octocat: Welcome to Open-source! Simply add your details to contributors | Repo for Hacktoberfest 2020 ✅
swagger-docs
:
Generates swagger-ui json files for Rails APIs with a simple DSL.
etcdadm
:
[EOL] etcdadm is a command-line tool for operating an etcd cluster
go-clean-architecture
:
Simple API for banking routines using a Clean Architecture in Golang :credit_card: :moneybag: :money_with_wings:
aimock
:
Mock everything your AI app talks to — LLM APIs, MCP, A2A, AG-UI, vector DBs, search. One package, one port, zero dependencies.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
mihome-binary-protocol
?
Download (.md)
# Xiaomi's MiHome Binary protocol ## Summary Xiaomi is a manufacturer of smart home devices under the "MiHome" label. These devices use an encrypted, proprietary network protocol to communicate with the official smartphone app. It operates on UDP port 54321. This repository documents the protocol, henceforth referred to as "mihobi", and contains exemplary source code to parse and analyze. The main goal is to remove the dependence on proprietary software, and to regain control over your own devices. It has been developed with the _Yeelight RGBW smart bulb_. Other devices might use yet unimplemented features.  ## Documents [doc/PROTOCOL.md](doc/PROTOCOL.md) ## Tools ### pcap-decrypt.py Recovers the protocol from pcap-ng dumps and attempts to decrypt the packet payloads. Dependencies: * Python 3.5+ * [tshark](http://wireshark.org/), the command-line version of Wireshark * [PyShark](https://kiminewt.github.io/pyshark/), a Python wrapper for tshark * [cryptography](https://cryptography.io/), a Python library which exposes cryptographic recipes and primitives. Installation: apt-get install tshark pip3 install pyshark pip3 install cryptography Usage: ./pcap-decrypt.py capture.pcapng.gz Example output: ### 192.168.13.2 => 192.168.13.1 (xx:xx:xx:xx:xx:xx => yy:yy:yy:yy:yy:yy) META: Hello ### 192.168.13.1 => 192.168.13.2 (yy:yy:yy:yy:yy:yy => xx:xx:xx:xx:xx:xx) META: device yy:yy:yy:yy:yy:yy has token: abcdef1234567890abcdef1234567890 ### 192.168.13.2 => 192.168.13.1 (xx:xx:xx:xx:xx:xx => yy:yy:yy:yy:yy:yy) {"id":1234567890,"method":"miIO.config_router", "params":{"ssid":"WiFi name","passwd":"WiFi password","uid":987654321}} ### 192.168.13.1 => 192.168.13.2 (yy:yy:yy:yy:yy:yy => xx:xx:xx:xx:xx:xx) {"result":["ok"],"id":1234567890} ### miio.py Core Python library that parses and generates MiHoBi packets. ## Notes As of 2017-02-10, the initialization process ("SmartConnect") leaks the user's WiFi credentials, due to weak encryption. See `PROTOCOL.md` for more details. I do not recommended connecting MiHome devices to your main WiFi network. ## Appendix ### Legal Xiaomi is a registered trademark and service mark of Xiaomi Inc., which is not affiliated with the maker of this program and does not endorse, service or warrant the functionality of this product. ### Author The source code and documention in this repository (c) 2016-2017 Wolfgang Frisch Licensed under the GPLv3.
