NodeSpotHeating

Spotheat Node - showing 0.45 euro for 15 minutes of heat

Node for paying for spot heating in the Metal area (the thing `high up'). Part of the Space tegoed payment system.

What does it do?

The display normally displays a static price. The price is for 15 minutes of heating.

Swipe your door tag just once to get 15 minutes of heating.

Once you've swiped - the display changes from the price to a countdown timer; starting at 15:00.

At this point you can use the remote control to switch the actual heater.

The box then starts counting down; showing every second to 14:59, 14:58 and so on. During this time the heating is ON. Once it reaches 00:00 - the heating switches OFF.

You can swipe at any time - and if your payment clears; you simply get another 15 minutes added to the `on time' counter.

Hardware vervangen/repareren

See SpaceTegoed for technical information, Payment and Paring REST protocol for the protocol and [github for code]. De node is een variant van de Payment Terminal with 4 seven segment displays - maar heeft een extra relay op pin 12 met een NPN register en 10k pull down / 1k feed.

Note that you *must* unseat the power connector before plugging in the USB (or take out the ESP32). For this reason; the green powerplug has been mounted in such a way that it is almost impossible to plug in the USB without unplugging that connector (i.e. as a gentle reminder). Once it is programmed for the first time - it can be reprogrammed over OTA; and does not need the USB anymore. You can `see' the serial output by telnet-ing in (see below), watching MQTT, the build in webserver, etc.

Important for maintainers

The descriptive name of the node in the CRM needs to start with the minutes of heating provided; as digitas; as the very first thing in the descriptive text. E.g. "15 minutes of heating" or "15 minuutjes warmte". As the software picks up this as the countdown value (together with the price). It interprets this as minutes.

If the descriptive text does not start with a (non zero) number -- the unit becomes a normal payment terminal. That does not count down.

Main code at https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/

known bugs in version 1.07 /CC2AF4

Deployed is https://github.com/MakerSpaceLeiden/makerspaceleiden-payment-node-7segments/tree/1.07

1. Pin 25/26 swapped
2. PSU a bit bare, top relay needs captontape
3. Needs grounding
4. Glands may be too small
5. No LED on relay
6. Need to also use remote not quite ideal

Versions build

Node Spot Heating

• Wifi-Mac address ends with CC2AF4

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

Extra circuit to switch off and on the 220v to the heater.

The diode is drawn the wrong way round in above circuit.

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. On the Mac [Discovery] is ideal.

The most recent IP address is shown below. Update this if you replace the hardware; or if you find it has moved IP address.

MAC	Versie	Mac address	IP address
NodeSpotHeating	1.07	C8:C9:A3:CC:2A:F4	192.168.6.125

Version deployed as of September 2022: https://github.com/dirkx/makerspaceleiden-payment-node-7segments/releases/tag/v1.07

A typical session looks like:

$ telnet 192.168.6.125 23
Spotheater@4x7-1-07-cc2af4 Serial connected C8:C9:A3:CC:2A:F4
Good scan
Payment completed successfully.

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 
Spotheater {
  "rfid_scans": 2,
  "rfid_misses": 0,
  "ota": true,
  "state": 3,
  "IP_address": "192.168.6.125",
  "Mac_address": "C8:C9:A3:CC:2A:F4",
  "Paid": 0.45,
  "PaidSeconds": 900,
  "Version": "F1-07",
  "Firmware": "4x7-1-07-cc2af4",
  "heap": 213732,
  "coreTemp": 56.7,
  "loopRate": 19.9
}

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. There is no leading zero.
   2. [--] - in the process of paying
   3. FAIL - payment failed
   4. paid - you have paid
   5. MM:SS -- a minute and second countdown. Once at zero - the heating switches off. There is always a leading zero.
   6. 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
      1. FO:AF - OTA authentication failed
      2. FO:BF - OTA begin failed
      3. FO:CF - OTA connect failed
      4. FO:RF - OTA receive failed
      5. FO:EF - OTA end failed
      6. FO:OF - OTA 'other' failure
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.

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

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 - 7 euro - wat groter dan normaal; https://www.amazon.nl/Lon0167-200x120x75mm-doorzichtige-Kunststoffabdeckung-Anschlussdose/dp/B0842J3HLW/ref=sr_1_30 (hoewel die vrij groot is).
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 relays - 5 Volt, voor 230 VAC / 30 Ampere, lots of watt (herkomst https://www.baco-army-goods.nl - prijs onbekend)
7. 2 doorvoerwartel; 12mm: 0.35 euro (voorraad space, https://www.aliexpress.com/item/32866592761.html)
8. restje print (https://www.benselectronics.nl/experimenteer-printplaat-12-x-18-cm.html)
9. stukjes dik koper draad (VD draad) om het 220v pad via relays de heater wat op te dikken.
10. 10k weerstand 1/8 watt ((https://www.baco-army-goods.nl/)
11. 1k weerstand 1/8 watt ((https://www.baco-army-goods.nl/)
12. BC5476 transistor, NPN (https://www.bitsandparts.nl/Transistor-BC547-NPN-45V-0-1A-p115143)
13. printconnector met steker, 4 pins
14. kroonsteentje voor aarde.
15. netsnoer - weggooikast space
16. draadjes - electronica hoek
17. 4x korte nylon boutjes voor de RFID lezer met moer (ook nylon ivm radio interference)
18. twee dunne boutjes/moertjes voor het display (1.5mm)
19. epoxy voor lijmen boutjes aan doorzichtig frontje
20. labels uit de label printer

Totaal: < 30 euro; 60 minuten solderen/assemblage en wachten tot de epoxy droog is.

Compileren software

1. Installeer een recente versie van [[1]].
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. Check ook global.h 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.