Allt i ett

I det här upplägget gör en maskin allt: kassan, inställningarna, skrivartjänsten och kontrollenhetens brygga körs på samma dator eller terminal, och skrivare, kontrollenhet och kundskärm sitter direkt på den. Inga delar behöver nå varandra över nätet, så allt lyssnar bara på 127.0.0.1 - utom en Nets-terminal, som ringer in till kassan.

Windows-dator

Det här behövs

• Windows 10 eller 11, 64-bitars, med Microsoft Edge WebView2 Runtime (följer med Windows; installationen varnar om den saknas).
• En kvittoskrivare installerad i Windows med tillverkarens drivrutin eller “Generic / Text Only”.
• CleanCash på en serieport (COM).
• Gärna en andra skärm som kundskärm.

Installera

1. Hämta windows/R-GO-windows-<datum>.zip, packa upp och dubbelklicka Installera.cmd. Den ber själv om administratörsrätt.
2. Döp kvittoskrivaren i Windows till Kvittoskrivare (Inställningar → Skrivare → Egenskaper), eller ange dess namn i nästa steg.
3. Öppna R-GO Skrivarinställningar i startmenyn (lösenord R-go-go, byt det på sidan). Välj Windows skrivarkö och kön, kryssa i “CleanCash är ansluten här”, välj serieporten med “Visa serieportar”, och spara. Tryck Starta om tjänsten och sedan Skriv ut provsida.
4. Öppna R-GO Inställningar och lägg in företagsuppgifter, moms, varugrupper, knappar och kortterminal.
5. Starta R-GO Kassa och R-GO Kunddisplay.

Programmen hamnar i C:\Program Files\R-GO, allt butiksspecifikt i C:\ProgramData\R-GO. Tre tjänster startar med Windows: kassan, inställningarna och skrivartjänsten. Kassan visas på första skärmen och kunddisplayen på den andra - vilken som är vilken styrs av ordningen i Windows skärminställningar.

Kortterminal

• Nets: terminalen ringer in till kassan på port 20002. Kassan måste då lyssna på nätet: ändra "--http", "127.0.0.1:8090" och "--ws", "127.0.0.1:8091" till 0.0.0.0 i C:\ProgramData\R-GO\services.json och öppna port 20002 i brandväggen.
• Worldline: kassan ringer upp terminalen. Lägg nycklarna i C:\ProgramData\R-GO\config\worldline_keys.json och välj terminalen i inställningarna (den syns där när UDP 8000 är öppen).

CHD6800

CHD6800 är en allt-i-ett-terminal med Android 5.1, inbyggd skrivare och CleanCash på egna serieportar. APK:n kör allt på terminalen.

1. Stäng av leverantörens kassaapp, som annars håller skrivaren: adb shell pm disable com.chd.ecroandroid
2. Installera: adb install -r R-GO-chd6800-<datum>.apk
3. Starta R-GO på terminalen. Vid första start läggs webbklienten och standardinställningarna på SD-kortet (/storage/extsd/rgo).

Skrivaren (/dev/ttymxc4) och CleanCash (/dev/ttymxc3) är inställda i APK:n. Kvittot skrivs som text eftersom serieporten är för långsam för bilder; loggan lagras i skrivarens minne och kommer med ändå. Inställningarna nås på två sätt. På terminalen öppnar knappen Webb (nere till höger) dem, och bakåtknappen tar dig tillbaka till kassan. Från en dator i butiksnätet når du dem på http://<terminalen>:8092 med lösenordet R-go-go; användarnamnet spelar ingen roll. Byt lösenordet i en riktig butik: lägg SHA-256 av det nya i config/web_setup_losen.txt (printf %s 'nytt' | sha256sum). Rutnätsredigeraren fungerar bäst från datorn, eftersom terminalens webbläsare saknar CSS Grid. Kassan lyssnar också på nätet, så att en Nets-terminal kan ringa in.

Knapparna har CHD:s egen form, samma som leverantörens app: 12 × 7 rutor över hela skärmen med varugrupperna till vänster, displayen uppe till höger och siffror och betalsätt nere till höger. Den följer med som standardinställning, så den gäller vid en ny installation; en terminal som redan har inställningar behåller sina knappar. Formen hämtas ur config/layouts/ecro.* och kan ändras i inställningarnas rutnät som vilken layout som helst.

En kundskärm i HDMI-uttaget visar kundsidan av sig själv - priser, summa och 2 × 20-raden - i stället för att spegla kassan. Utan kundskärm händer ingenting.

Casio V-R100 och V-R200

Casio-kassorna (Android 2.3 och 4.2) styr skrivare och serieportar genom Casios egna gränssnitt, så här är det Casio-appen som skriver ut och är brygga för CleanCash.

1. Installera R-GO-casio-kassa-<datum>.apk. Installera inte även skrivarappen - de delar port 8080.
2. Starta R-GO kassa. Inställningar och webbklient läggs på den externa lagringen vid första start.

CleanCash ska sitta på COM1. Skrivaren klarar text och logga men inte QR-kod och inte fetstil (rubriker skrivs i dubbel bredd). Kassan på Casio är inte provad på hårdvaran än; störst osäkerhet är webbvyn på Android 2.3.

Linux eller Mac

För en kassa på en Linux-dator eller en Mac finns arkiv med programmen, webbklienterna och standardinställningarna.

tar xzf R-GO-linux-x86_64-<datum>.tar.gz && cd R-GO-linux-x86_64-<datum>
mkdir -p ~/rgo && cp -r config web/* ~/rgo/
bin/receiptprinter --printer-only --http 127.0.0.1:8088 --config ~/rgo/config/receiptprinter.json
bin/web_till  --data-dir ~/rgo --http 127.0.0.1:8090 --ws 127.0.0.1:8091
bin/web_setup --data-dir ~/rgo --http 127.0.0.1:8092

Kör dem som tjänster (systemd på Linux, launchd på Mac) så att de startar med datorn. Kassan öppnas i webbläsaren på http://127.0.0.1:8090/, kunddisplayen på /customer/. Skrivaren och CleanCash ställs in på http://127.0.0.1:8088/setup. På Mac: kör xattr -dr com.apple.quarantine . i katalogen en gång - programmen är inte signerade.

En USB-skrivare på Linux kräver att användaren får skriva till USB-enheten (en udev-regel för skrivarens tillverkar- och produkt-id), och serieporten att användaren är med i gruppen dialout.