Slotcar buddy - Bluetooth based connection for your Carrera Digital system
Allgemein - WebService API (ab App Version 1.0.7)
Als Übertragungsformat wird JSON verwendet. Die WebServer API kann über Http angesprochen werden (z.B. http://192.168.0.126:8080/api). Der WebServer wird von Benutzer in der App manuell gestartet. Mittels GET können spezifische Anfragen gestellt werden (z.B. http://192.168.0.15:8080/api/getserverinfo). Möglich sind aktuell:
- getserverinfo (liefert Antwort "serverinfo")
- getdrivers (liefert Antwort "driverinfo")
- getraceinfo (liefert Antwort "raceinfo")
- gettrackstate (liefert Antwort "trackstate")
Eine Beispielimplementierung kann in der MonitorApp "default" eingesehen werden. In der Slotcar buddy App wird diese über "Einstellungen Allgemein" installiert. Nach der Installation erscheinen die entsprechenden Dateien unter "SD_CARD\CarreraRace\www".
Allgemein - WebSocket API (Obsolete)
Als Übertragungsformat wird JSON verwendet. Der Server kann über den Port 11080 angesprochen werden (z.B. ws://192.168.0.126:11080/). Er wird von Benutzer in der App manuell gestartet. Der Server sendet bei erfolgreichem Verbindungsaufbau eine "serverinfo" Antwort. Diese API sollte nicht mehr verwendet werden. Mit einer der nächsten App Versionen steht diese nicht mehr zur Verfügung. Verwendet Sie stattdessen die WebService API.
Allgemein - Eigene MonitorApp erstellen
Mit der Version 1.0.7 können neu "MonitorApps" mit Html entwickelt werden. Eine Implementierung davon wird nach dem Appstart unter "SD_CARD\CarreraRace\www" erstellt. Diese ist direkt für den Einsatz verwendbar. Über "Einstellungen Allgemein" kann diese zurückgesetzt werden. Alternativ kann auch einfach der Ordner auf der SdCard gelöscht werden.
Für jede neue App muss in "SD_CARD\CarreraRace\www" ein neuer Ordner erstellt werden. Dieser darf keine Sonderzeichen oder Leerzeichen im Ordnernamen enthalten. Der bereits vorhandene Ordner "default" sollte nicht verändert werden. Bei jedem AppStart werden sämtliche Dateien in diesem Ordner überschrieben. Slotcar buddy erkennt neue Ordner automatisch als MonitorApp und bietet diese beim Webaufruf nur Nutzung an.
Allgemein - MonitorApp starten
In der App Slotcar buddy muss mit aktivierten WLAN im Menu mit der Funktion "START SERVER" der integrierte Webserver gestartet werden. Die dort angezeigte IP und Port (z.B. 192.168.0.10:8080) kann auf jedem beliebigen Endgerät im Browser eingegeben werden. Es wird die Standardseite mit den erkannten MontorApps zur Auswahl angezeigt.
Antwort "serverinfo"
Enthält Infos über den Server. apps definiert eine Liste von Apps, welche über die MonitorApp (Http) zur Verfügung stehen. Dabei wird jeder Ordner in "SD_CARD\CarreraRace\www" als App betrachtet.
{
"type": "serverinfo",
"data": {
"servername" : "Slotcar buddy server",
"serverversion" : 5,
"apps":[
{ "name":"default" },
{ "name":"bigscreen" }
]
}
}
Antwort "driverinfo" (ab App Version 1.0.7)
Enthält Infos über die ausgewählten Fahrer.
{
"type": "driverinfo",
"data": {
"driver":[
{ "carnumber":2, "displayname":"Schlaubi", "color":"#00FF00" },
{ "carnumber":1, "displayname":"Jessy", "color":"#0000FF" },
],
}
}
Antwort "raceinfo"
Enthält Infos über den Rennstatus. Für "racetype" können folgende Werte geliefert werden:
- practise
- racelaps (Rundenrennen)
- racetime (Zeitrennen)
{
"type":"raceinfo",
"data":{
"racetype":"racelaps",
"timerunningmillis":2000,
"lapsdriven":1,
"lapstotal":5,
"timetotalmillis":0,
"ranking":[
{
"laps":4,
"rank":1,
"timelastlap":1234,
"gapmillis":0,
"timetotalmillis":5000,
"color":"#0000FF", (OBSOLETE AB 1.0.7)
"driver":"Car 1", (OBSOLETE AB 1.0.7)
"carnumber":1 (AB 1.0.7)
},
{
"laps":3,
"rank":2,
"timelastlap":1456,
"gapmillis":222,
"timetotalmillis":4500,
"color":"#00FF00", (OBSOLETE AB 1.0.7)
"driver":"Car 2", (OBSOLETE AB 1.0.7)
"carnumber":2 (AB 1.0.7)
}
]
}
}
Antwort "trackstate"
Enthält Infos über die Startampel und die Fahrzeuge (z.B. Tankstand). Für "startlight" können folgende Werte geliefert werden:
- raceisrunning
- startbuttonpressedonce (alle LEDs sind an)
- ledon1
- ledon2
- ledon3
- ledon4
- ledon5
- ledallon
- falsestart
- unknown
{
"type":"trackstate",
"data":{
"startlight":"raceisrunning",
"fuel":[
{ "fuel":12, "carnumber":1 },
{ "fuel":100, "carnumber":2 },
{ "fuel":100, "carnumber":3 },
{ "fuel":100, "carnumber":4 }
],
"carsinpitlane":[
{ "carnumber":1 }
]
}
}
Diverses
Ideen und Verbesserungsvorschläge nehmen wir gerne entgegen über
IdeaInformer oder direkt per Mail.
