bilogic / logitech-unifying-device

Use ESP8266 and NRF24L01+ as a wireless Logitech Unifying keyboard/mouse

Library to build Logitech Unifying compatible devices

I have always wanted an 84 key standard layout, wireless, mechanical keyboard with RGB backlight and rotary knobs plus media control buttons near the spacebar. Anyway, it did not take long for me to realize that bluetooth keyboards are notoriously unreliable, intermittently disconnecting every so often. However, Unifying ones are much better.

I never planned to publish this code, thus it is not the cleanest. But since I'm stuck, I thought someone might put it to good use and maybe figure out the problem. If you can make a more secured Unifying compatible protocol, all the better.

C-U0007 mitigation effort from firmware 012.010.00032 onwards

In an effort to prevent keys injection, the receiver's firmware will reject packets that start with a full buffer of 6 keystrokes, so start by filling the buffer slowly (like a human). If you know exactly how the receiver rejects these packets, feel free to PR a write up.

Many thanks to:

• Ronan Gaillard ronangaillard/logitech-mouse#5
• RoganDawes and Marcus Meng RoganDawes/LOGITacker#55
• Code to perform AES ECB mode, will gladly attribute it if someone knows its origin

Hardware

• Logitech C-U0007 dongle
• ESP8266, NRF24L01+ and a 5v power board for the NRF24L01+ module, connect them as follows:
  • WEMOS D1 mini D3 <-> power board CS
  • WEMOS D1 mini D4 <-> power board CE
  • WEMOS D1 mini D5 <-> power board SCK
  • WEMOS D1 mini D6 <-> power board MISO
  • WEMOS D1 mini D7 <-> power board MOSI
  • WEMOS D1 mini 5V <-> power board VCC
  • WEMOS D1 mini GND <-> power board GND

Software

• Open logitech-unifying-device.code-workspace in VSCode with PlatformIO installed
• Press ctrl + alt + u to compile
• If it is your first time using PlatformIO, wait until the icon appears on the activity bar at the left of VSCode before compiling, it should just work

logitech-unifying-device's Issues

DIYing a unify receiver

Hi,
Thanks for your efforts into this. I am thinking about implementing a Unify receiver using a nrf24 module. Since I dont have one its really hard for me to reverse engineer it. Can I pick your brains to how you went about doing one? Thanks a lot for any inputs you might have.

Able to connect to dongle but doing nothing

Hello , I tried your code and the NRF24L01 is able to connect to the dongle but the module isn't doing anything on the computer. Do you know what is causing this issue?

I have a question.

Thank you for the great library.
I am not good at English. I ask for your understanding.
When I reconnect the device, the mouse-related packets work well.
However, the keyboard device must be re-paired.
Otherwise, keyboard command is not possible.
Can I get your email address? I want to send you my full source code.

C-U0007 firmware 012.010.00032 dongles does not accept encrypted keyframes

Based on discussion and analysis here RoganDawes/LOGITacker#55, I suspect the latest firmware (012.010.00032) has some way to verify the counter from a real device and reject keyframes that do not count properly

More info shared here https://www.reddit.com/r/LiveOverflow/comments/g8ajed/reverse_engineering_of_logitech_unifying_firmware

Feel free to ask questions or post if you managed to solve this.