christian
3905647b7f
Firmware, Bluetooth-Brücke und Agent-Skill für den KOSMOS-Proxi: einmal flashen, danach hört der Roboter über Bluetooth LE auf Textbefehle. Was die Befehle schickt, ist ihm egal — ein Skript, ein curl, oder ein KI-Agent, der aus "mach mal was Lustiges" eine Choreografie baut. firmware/ MakeCode-Projekt (TypeScript) und fertige .hex für V1 und V2 bridge/ BLE-Brücke und HTTP-API, einzige Abhängigkeit ist bleak agent/ Skill-Definition: Alltagssprache -> Befehle tools/ Quelltext aus .hex extrahieren, Musik-Tabellen prüfen docs/ Protokoll, Einrichtung, Hardware, Lizenzen Zwei Dinge, die sonst nirgends stehen und in docs/HARDWARE.md dokumentiert sind: die Pin-Belegung des Roboters ist nicht öffentlich, sie wurde aus den mitgelieferten .hex-Dateien rekonstruiert (tools/hex_source.py holt sie heraus). Und der Ton braucht zwingend eine ganzzahlige Frequenz sowie Pin P0 — sonst kracht der Lautsprecher, der Aufruf hängt und die Bluetooth- Verbindung stirbt. Am echten Roboter durchgetestet: Verbindung, Sensoren, Display, 41 Sekunden Musik am Stück, alle Bewegungsrichtungen, Musik und Fahren gleichzeitig, Tanzfiguren, Not-Stopp mitten in der Bewegung, Autostart nach Neustart. MIT-Lizenz. Die Hardware-Extension stammt von kaku111 (TobbieII) und die Notendaten aus pxt-microbit, beide ebenfalls MIT — siehe THIRD-PARTY-NOTICES.
2.8 KiB
Lizenzen und Herkunft
Eigener Code
MIT, Copyright (c) 2026 Christian Gärtner — siehe ../LICENSE.
Betrifft alles in diesem Ordner außer den unten aufgeführten Teilen:
firmware/main.ts bridge/proxi_bridge.py tools/hex_source.py
firmware/build.sh bridge/*.txt tools/check_melodies.py
agent/proxi-control.md docs/
Damit steht das gesamte Projekt unter MIT — auch die beiden fremden
Bestandteile sind MIT-lizenziert, es gibt also keine Reibung zwischen den
Lizenzen. Die fremden Copyright-Vermerke müssen bei der Weitergabe erhalten
bleiben; sie stehen dafür in
../THIRD-PARTY-NOTICES.
Fremder Code
firmware/proxi.ts — Hardware-Extension
Die komplette Hardware-Anbindung (Motoren, IR-Sensoren) stammt nicht von uns.
| Ursprünglich | Extension TobbieII von kaku111 |
| Lizenz | MIT (LICENSE.txt im Repo, "license": "MIT" in dessen pxt.json) |
| Weg hierher | Kosmos liefert eine eingedeutschte Fassung als custom.ts in den .hex-Dateien der Beispielprogramme mit; von dort mit tools/hex_source.py extrahiert |
| Änderungen | keine — nur ein Herkunftshinweis als Kommentar im Kopf |
Proxi und Tobbie II sind derselbe Roboter unter verschiedenen Namen. Kosmos'
eigenes Programm 12_APP_Fernbedienung hängt noch direkt an der
Original-Extension:
"TobbieII": "github:kaku111/20190209#9c728847d1a08815275108ec42009211d57c2f0d"
Der MIT-Lizenztext des Originals liegt im Wortlaut in
../THIRD-PARTY-NOTICES.
Notendaten in firmware/main.ts
Die Melodien in melodyBuffer() sind die 20 eingebauten Melodien von MakeCode,
Byte für Byte übernommen aus
pxt-microbit
(libs/core/melodies.ts, MIT, Copyright Microsoft Corporation).
Warum kopiert statt benutzt: der eingebaute Melodie-Player spielt in einem
eigenen Fiber ab und stürzt ab, sobald ein anderer Fiber gleichzeitig den
Audio-Pin anfasst. Die Begründung steht ausführlich im Kopf des
Musik-Abschnitts von main.ts.
Nicht mitveröffentlichen
Der Rest dieses Repos gehört Kosmos und ist kein Teil des Proxi-AI-Projekts:
Kosmos-Programme/ Beispielprogramme (.hex und extrahierter Quelltext)
Proxi_Manual.pdf Bedienungsanleitung
logo.png proxi.png Produktbilder
Für ein öffentliches Repo wandert dieser Ordner am Stück mit — er ist in sich geschlossen:
firmware/ bridge/ agent/ docs/ tools/
LICENSE THIRD-PARTY-NOTICES README.md
docs/HARDWARE.md ist so geschrieben, dass es auch ohne die übrigen
Kosmos-Programme verständlich bleibt, und README.md in diesem Ordner taugt
als Startseite des neuen Repos.