Python client for talking to a macro pad over USB serial. The single script in this repo (TestWritingToDevice.py) scans for the macro pad among connected serial ports, opens it, writes a line to it, and prints the four lines the device sends back — a smoke test that the host ↔ device serial protocol actually round-trips.

How it fits together

The whole project is one script plus a license:

├── TestWritingToDevice.py   # the entire app: find port → open → write → read 4 lines
└── LICENSE.txt              # GPL-3.0-only (copyright Lucas Oskorep)

There is no package structure, config, or dependency manifest — just the script.

Where the real behavior lives

Everything is in TestWritingToDevice.py, and the interesting bit is device discovery:

Port identification: it enumerates all COM ports via serial.tools.list_ports and picks the one whose hwid contains "DF60BCA" and whose product ID is 33032 (PID 0x8110). That hard-coded hwid/PID pair is the fingerprint of this particular macro pad — swap those constants and the script talks to a different device.
Protocol exchange: it opens the port at default baud rate, writes b"hello!\n", then reads exactly four lines back and prints each raw and decoded as UTF-8. The "four lines" expectation is baked into the loop count, mirroring whatever fixed-length reply the firmware sends per request.
Platform caveat: the discovery branch is commented as Windows-oriented ("Windows code for figuring out which port to grab"), since it relies on port.hwid being populated, which isn't guaranteed on Linux.

Setup

No build step or manifest. Just install PySerial and run the script with the pad plugged in:

pip install pyserial
python TestWritingToDevice.py

Expect FOUND MACROPAD! followed by the device's reply lines if the pad is detected.

Notes

Licensed under GPL-3.0-only (LICENSE.txt, copyright Lucas Oskorep).
Remote: gitea.chaosdev.gay:lucasoskorep/macropados-client — the "client" half of a presumably separate macro-pad OS/firmware project.