The doc folder of the repository contains a two-part documentation of the proprietary radio protocol BidCos, which was developed by the company eQ-3 and is used in their smart home product line HomeMatic.
The first part deals with the general protocol description of BidCos, while the second part describes possible attack vectors and their technical implementation on this protocol. How to perform experiments on different test setups is also described in this video tutorial.
⚠️ Since the documentation depends heavily on third party sources, we cannot guarantee its completeness or correctness! Please read the disclaimer carefully!
The urh folder contains files for implementing an attack using the software Universal Radio Hacker and an SDR like the HackRF One.
Requirements:
-
Latest version of Universal Radio Hacker
-
One SDR which can send/receive messages on 868 MHz (for some attacks a second SDR is needed)
-
Python3
The content of the folder doc is licensed under the CC-BY-4.0 license and the content of the urh folder is licensed under the GNU GPLv3 license.