Payment Terminal with 4 seven segment displays

experimental - security/privacy & reliability is not yet quite at the level required

Prototype voor bier/koffie afrekenen. Zie SpaceTegoed voor een overzicht/plan, Payment and Paring REST protocol for the protocol and [github for code].

Prototype simpele/een functie terminal; betaling van 1.75 euro

Wat doet het

Bij dit type betaal terminal kan je maar voor één ding, met een vaste prijs, betalen.

Gebruikt instructie

1. Het 7 segment display toont het bedrag een euro's. (Dat blijft altijd hetzelfde (het komt elke nacht uit het CRM systeem - zie de prijslijst op https://makerspaceleiden.nl/crm/pettycash/).
2. Swipe je tag langs de terminal.
3. Het display toont '[--]' en vervolgens 'PAID'. Je hebt nu betaald. Je krijgt een emailtje met de details van je betaling. Hier staat het bedrag in; de naam/locatie van de terminal en eventueel een beschrijving. En je zit dit in het overzicht op de website.
4. Daarna gaat het weer terug naar stap 1.

Een filmpje van een prototype: https://vimeo.com/manage/videos/625531264

Indien de betaling fout gaat zie je de text 'FAIL' en een cryptische 3 cijferige foutcode.

Op de server wordt bijgehouden wat er fout ging. Als gebruiker kun je in dit geval niet veel meer doen dan via het CRM betalen, cash betalen, het bij de mailing lijst melden, of het later weer proberen.

Trouble shooting

It is possible to 'telnet' into these units (on the normal telnet port #23) and see what normally would come out of the serial port. The units also sent their logging to syslog (to the spaceserver, 192.168.6.1).

Check the firewall, use a [MDNS] [resolver] (or simply the Arduino IDE) to discover their IP address. You can do this from the RaspPi next to the VinylCutter / Vinylsnijder.

MAC	Versie	Mac address	IP address
Bier	1.05	3C:71:BF:43:0F:E4	192.168.6.131
Koffie	1.05	24:0A:C4:97:2B:74	192.168.6.189

Version deployed as of November 2021: https://github.com/dirkx/makerspaceleiden-payment-node-7segments/releases/tag/v1.05

A typical session looks like:

$ telnet 10.13.0.241 23
4x7-F1-05-430fe4 Serial connected 3C:71:BF:43:0F:E4
Good scan
Payment completed successfully.
Wed Nov  3 19:02:11 Heap: 181 Kb

Any error message (post joining the Wifi network) will show up here. If the issue is prior to joining WiFi - you will have to connect a USB cable (Baudrate 115200, 8N1). The Raspi has the right drivers installed.

Furthermore - if you connect to space.makerspaceleiden.nl via MQTT - then you can also see the output:

TOPIC: ac/log/tft-1.04-cbb67c 
   Grijpvoorraad {
  "rfid_scans": 0,
  "rfid_misses": 0,
  "ota": true,
  "state": 3,
  "IP_address": "192.168.6.200",
  "Mac_address": "C8:C9:A3:CB:B6:7C",
  "Paid": 0,
  "Version": "1.04",
  "Firmware": "tft-1.04-cbb67c",
  "heap": 139667
}

Display messages

1. During startup
   1. F X-YY - version number firmware during booting.
   2. CONN - connecting to WiFi
   3. NTP - getting the time
   4. F CA - Fetching the Certificate Authority
   5. F PL - Fetching the price list
   6. FAIL - failed to connect to WiFi; will reboot.
   7. any error message - scrolling error message & after which either reboot or hang if it unrecoverable.
2. At the end of startup (from this point onwards OTA is possible).
   1. ---- - fully started up; but have not yet gotten the pricelist
   2. no prices - price list could not be fetched. Will retry for a few minutes every 15 seconds; then reboot.
3. In normal payment mode
   1. X.YY - price to pay when you swipe
   2. [--] - in the process of paying
   3. paid - you have paid
   4. FAIL - payment failed
   5. any error message - scrolling error message.
      1. FAIL -1 - netwerk/wifi error. Powercyle de unit.
      2. FAIL -4 - netwerk/wifi error. Powercyle de unit.
      3. FAIL 40X Gebruik je een geldige tag ?
      4. FAIL 500 Error op de server; mail noc@.
4. During Over the Air reprogramming.
   1. PROG - start of OTA update
   2. F XX - OTA; uploading new firmware; XX is the percentage fetched
   3. DONE - successful end of OTA. Unit will reboot.
   4. any error message - scrolling error message & after which the device will switch back to the old/current firmware
5. During initial pairing / post an OTA
   1. REG Registering with the server
   2. PAIR requesting to pair; swipe an admin tag.
   3. any error message - scrolling error message.

3D printed prototype

Code is at https://github.com/MakerspaceLeiden/makerspaceleiden-payment-node-7segments.

Het 3D printje ([OpenSCAD en STL file]) in het code repository) is voor een stel afstandhouders & montage plaat die passen in een G21 doosje met transparant deksel. Zodat de RFID reader flush genoeg is om makkelijk pasjes te kunnen lezen. Er liggen nog G21 doosjes onder in de groene kast.

Er zit een kleine AC/5V DC schakelende voeding onder de montage plaat. Hiermee is alle 220 volt weggebouwd onder de montage plaat - die je 'extra' moet losschroeven na loshalen deksel. Er liggen nog wat van die voedingen in de E-laatjes.

Caveat prototype - de standoffs zijn 2mm korter gemaakt om net wat meer ruimte te krijgen bij het display. Dit is gecorrigeerd in version 1.03 in van de STL/openScad file in git.

Bill of materials

Materialen; duurste onderdelen eerst:

1. ESP32: 7 euro - https://www.amazon.nl/AZDelivery-Development-opvolger-compatibel-Inclusief/dp/B074RG86SR/ref=sr_1_9
2. PVC Doosje: 4 euro - [[aliexpress or Amazon [1], [2] or [3].
3. 7 segment display: 2.50 euro - https://www.amazon.nl/Youmile-Display-Gemeenschappelijke-Digitale-Man-vrouw/dp/B082193P1V/ref=sr_1_33
4. 1 RFID reader; ~2.50 Euro; (https://www.amazon.nl/gp/product/B074S9FZC5)
5. AC/5V transformer: 1.00 euro - https://www.aliexpress.com/item/33012749903.html
6. 1 doorvoerwartel; 12mm: 0.35 euro (voorraad space, https://www.aliexpress.com/item/32866592761.html)
7. netsnoer - weggooikast space
8. draadjes - electronica hoek
9. PLA (hoeft beslist geen PLA te zijn) - ~ 14 gram / krap 2 meter (voorraad space) om [[1]] uit te printen.
10. 4 spijkertjes & willekeurige (super)glue voor PVC/PLA -- om de standoffs onder de montage plaat wat extra steun te geven middels de gaatjes in het kastje (voorraad space)
11. drie tie-wraps (voorraad space)

Totaal: < 20 euro; 4 uur printen; 30 minuten solderen/assemblage.

Compileren software

1. Installeer een recente versie van [[2]].
2. Installeer een stable versie van de SDK voor de ESP32 volgens https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html
3. Selecteer in tools het platform ESP32 en dan het board dat je gebruikt (WRover, Devkit)
4. Installeer via de 'Library' optie de bibliotheken MFRC522-spi-i2c-uart-async, TM1637TinyDisplay en Arduino_JSON
5. Haal een git/zip versie op van https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/
6. Zet de #defines met de netwerk namen goed. Kies een unique terminal naam.
7. Overleg met noc@ voor een 'bearer token' voor toegang als je de productie versie maakt.
8. Idem voor het OTA wachtwoord.
9. Compiler & flash via serial (daarna kan het via OTA).
   1. Nota bene: with the cheaper boards; it may be needed to press 'BOOT' during the start of the programming.

Bouw instructie

• Print https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/blob/main/enclosure.stl
• Boor gat en monteer wartel in het kastje. Doe dit zo laag mogelijk.
• Stop 4 spijkertjes in de standoffs; laat ze 2mm uitsteken, zodat flush zitten in de gaatjes in de standoff van het kaste. Lijm ze alle 4 vast aan het kastje. Zodat je straks de montage plaat er op kan leggen.
• Soldeer alle wat te langen draden volgens https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/blob/main/wiring-rover.png aan de ESP32 print.
• Monteer de ESP32 print op de montage plaat. Steek de VIN/GND draad door het ronde gat naar onder. Voor het grote type moet je de twee standoffs die in de weg zitten wegknippen. Voor de korte print hoeft dat niet.
• Programeer de ESP32 met https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/blob/main/makerspaceleiden-payment-node-7seg.ino; laat te USB kabel er voorlopig in zitten.
• Monteer de RFID print en soldeer haar draden vast.
• Monteer de 7-seg print en soldeer die draden ook. Als de ESP32 haar kapje dicht bij de vrij lange pinnen van de 7-seg print komt - plak dan wat capton tape over het blikken kapje.
• Monteer de voeding met een tie-wrap onderop.
• Zorg voor goede trekontlasting netkabel en soldeer deze ook aan de voeding
• Leg de montage print op de standoffs - en doe er 4 pakkertjes door.
• Maak het bovenste puntje van de : zwart zodat het lijkt op een ..
• Maak het rode ledje van de RFID zwart.
• OPTIE: smelt de eindjes die door de printjes heen zitten.
• Soldeer daar ook alle draden aan.
• Test alles, haal usb kabel los en sluit het doosje.

Versions build

Beer node

• Wifi-Mac address ends with 430FE4
• Has Uses pin 15 rather than 15 and RST/IRQ is swapped
• Versie 1.02 van de mount plate.
• Standoffs niet platgespoten

Current software: https://github.com/dirkx/makerspaceleiden-payment-node-7segments/releases/tag/v1.05

Coffee node

• Wifi-Mac address ends with 972b75
• Correct wiring.
• Hole for the gland slightly too high.
• Versie 1.04 van de mount plate.
• Rode ledje is gedesoldeerd (want zwart maken lukte niet erg)

Current software: https://github.com/dirkx/makerspaceleiden-payment-node-7segments/releases/tag/v1.05