====== SI-Droid ROC ======

**SI-Droid ROC** är en Android-app för orientering som gör det väldigt enkelt att rapportera in online-stämplingar från skogen till [[http://www.olresultat.se/|ROC's webtjänst]]. Allt som behövs förutom själva SportIdent-kontrollen är en Android-telefon och en USB OTG-kabel.

<note important>**VIKTIGT för Android 6 och nyare:** Om du tänker använda SI-Droid ROC på en telefon med Android 6 eller nyare på en tävling så måste du manuellt undanta appen från Androids batterioptimering! 

Nyare Android har en funktion kallad **Doze mode** som gör att om telefonen ligger helt stilla i någon timme så tillåts inte appar längre att komma åt Internet, dvs appen slutar att rapportera in till ROC-tjänsten. Konfigurera vilka appar som ska undantas från batterioptimeringen under Inställningar -> Batteri -> Batterioptimering.</note>

===== Översikt =====

SI-Droid ROC gör det möjligt att placera ut kontroller i skogen som automatiskt skickar stämplingar till en central webtjänst i realtid. Detta möjliggör:
  * Liveresultat under pågående tävling
  * Online-stämplingar utan fysisk radiolänk
  * Billig lösning jämfört med traditionell radioutrustning
  * Enkel installation - bara en telefon och en USB-kabel

===== Första användning =====

Detta måste göras första gången appen används på en ny telefon för att registrera ROC-enheten:

  - Gå in under **Inställningar** i appen och konfigurera **ROC namn** till ett vettigt namn för ROC-enheten (t.ex. "Kontroll 31" eller "Start")
  - Gå tillbaka till huvudsidan och starta sändning/mottagning genom att trycka på **Start-knappen**
  - Tryck även **Starta** i dialogen som kommer upp (det behöver i detta läge inte finnas någon kontrollenhet ansluten)
  - Det som händer då är att appen skickar sin unika MAC-adress till ROC's webtjänst för första gången, vilket skapar en helt ny ROC-enhet
  - Stoppa sändning/mottagning igen efter ca 30 sekunder genom att trycka på **Stopp-knappen**
  - Surfa in på [[http://roc.olresultat.se/|roc.olresultat.se]] och se att du hittar din nyregistrerade ROC längst upp i listan
  - Klicka på **Configure** långt ut till höger och skriv sedan in ett lösenord, kontaktnamn och e-post för ROC-enheten och spara konfigurationen

Efter denna första uppstart och inställning kommer telefonen alltid att vara knuten till just den ROC-enheten via den telefonunika MAC-adressen. Enda gången du behöver konfigurera något mer är när du sedan vill ansluta ROC-enheten till en viss tävling och få ett tävlingsnummer.

===== Anslut kontroller =====

Appen kan hantera alla typer av mastrar med sladd, både USB och serie-varianten (via USB-till-serie-konverter). Det är även möjligt att ansluta flera mastrar samtidigt genom att använda en USB-hubb.

==== Mastertyper och status ====

När en master ansluts försöker appen autodetektera baudrate och typ av master. Enheterna kan ha tre olika statusar:

  * **Grön = Användbar** - Mastern är korrekt konfigurerad (läge: Kontroll, Clear, Check, Start eller Mål, och Autosend påslaget)
  * **Röd = Inte användbar** - Mastern är felkonfigurerad (troligtvis läge Readout eller Autosend avslaget)
  * **Gul = Okänd** - Ingen master svarade vid autodetektering (kan vara OK om bara en konverter eller samlingsbox är ansluten)

===== Normal användning =====

På huvudsidan listas alla stämplingar som tagits emot från kontrollen. Varje rad visar:
  * Brickans nummer
  * Kontrollens kodsiffra
  * Tiden för stämplingen (enligt tiden i mastern)
  * Markering om stämplingen skickats iväg eller inte

Precis ovanför listan syns:
  * ROC-enhetens namn
  * Antal stämplingar som väntar på att skickas (röd bakgrund)
  * Totalt antal stämplingar som skickats (grön bakgrund)

==== Funktioner ====

  * **Start/Stopp** - Startar och stoppar kommunikationen med ROC's webtjänst. När du trycker Start väljer du hur många timmar enheten ska vara aktiv
  * **SI-Mastrar** - Öppnar masterdialogen
  * **Hjälp** - Visar hjälptext
  * **Inställningar** - Öppnar inställningar
  * **Stämplingar hos ROC** - Öppnar webbläsare med sidan för alla mottagna stämplingar
  * **Rensa stämplingar** - Tömmer alla stämplingar i appen (gör detta inför varje ny tävling)
  * **Avsluta** - Avslutar appen helt

<note tip>Appens fönster behöver inte vara framme för att mottagning och sändning ska fungera. Så länge ikonen i notifieringsfältet syns så fungerar sändning och mottagning i bakgrunden. Telefonen kan då samtidigt användas till andra saker. Fungerar även när skärmen är släckt och låst.</note>

===== Inställningar =====

  * **ROC namn** - Namnet på ROC-enheten som kommer att synas i listan i ROC's webtjänst
  * **Intervall för att skicka stämplingar** - Tidsintervall mellan 10 sek till 5 min som avgör hur ofta appen ska skicka nya stämplingar
  * **MAC-adress** - En genererad MAC-adress som är unik för telefonen och identifierar ROC-enheten (går inte att ändra)
  * **Fallback baudrate** - Används när auto-detektering misslyckas (t.ex. vid konverter eller samlingsbox)

===== Systemkrav =====

  * Android-telefon
  * SportIdent-kontroll med master
  * USB OTG-kabel (kan köpas för under 100 kr hos Kjell & Co eller Clas Ohlsson)
  * Eventuellt en mini-USB-hub om flera kontroller ska anslutas
  * Mobilnät eller WiFi-täckning

===== Länkör =====

  * [[https://play.google.com/store/apps/details?id=se.joja.sidroid.roc|SI-Droid ROC på Google Play]]
  * [[http://roc.olresultat.se/|ROC's webtjänst]]
  * [[https://www.joja.se/|SI-Droid Wiki med dokumentation]]

===== Se även =====

  * [[si-droid_event|SI-Droid Event]] - För resultathantering
  * [[roc|ROC (Radio Online Controls)]] - Mer om ROC-systemet
  * [[start_och_resultatlistor|Start- och resultatlistor]]