1. basics of the project

• The basis for this tutorial is the hardware, e.g. the kit from fulmo.org:
• https://shop.fulmo.org/product/the-lightning-atm-bitcoin-construction-set/
• Alternatively you can get the parts separately. Here you can find a parts list.
• The software from the Github project: https://github.com/21isenough/LightningATM

Below is some more documentation that you can look at, but are not required for implementation:

• The original LightningATM documentation, for the large version with camera and stylus:
• https://docs.lightningatm.me/
• The manual from Fulmo, made especially for the Pocket Edition:
• https://blog.fulmo.org/the-lightningatm-pocket-edition/

Recommended tools:

• Slotted screwdriver, mulitimeter, side cutters, double sided tape (thick/thin), electrical tape, needle nose pliers, hot glue, magnifying glass, luster terminals, soldering iron (if available).

Just go through the following instructions step by step, then you will reach your goal the fastest.

2. hardware preparation

2.1 Prepare voltage hanger

• Cut the Micro USB cable. Approx. 15 cm from Micro USB connector
• Strip both ends and solder them together in parallel (++ / –) if soldering iron is available
• Connect both ends to the input of the voltage converter and screw it down
• Connect USB plug to power supply or USB Powerpack
• Connect a voltmeter on the output side
• Use a screwdriver to turn the small rotary potentiometer (see picture) several times (probably left first) until the voltage shows 12.1 volts
• Caution: The initial voltage can be very high. With me it was 35 volts. So don’t connect directly to the coin tester and adjust the meter to the correct range.
• Prepare conductors for the output side:
• Connect plus and minus (GND) from the voltage transformer to the coin acceptor.
• Connect one wire from GND of the voltage converter to terminal 25 of the Raspberry Pi
• See the wiring diagram below the pictures

2.2 Configuring the coin selector (6 pieces, 5 cents to 2 euros)

• Set the switch on the coin acceptor to "NO" and "Medium
• Apply 12V to the coin acceptor (without Raspberry Pi)
• Press and hold the ADD and MINUS button at the same time until A appears in the display
• When B appears switch back to A with a push button
• Press the SET key and hold it for a short time, then E appears in the display
• This indicates that you are now in the menu for the number of different coin types.
• Use ADD (or MINUS) to set the number of coins to 6 (coins = 5 cents to 2 euros) and press SET.
• Now the display shows H1 (for first coin) and the first of 6 LEDs is on
• Now indicate how often the coin is to be inserted for calibration
• Use ADD (or MINUS) to set to 20 and then press SET
• The display now shows P1 for further settings of coin 1 and you can define the output signal
• 5 cents = 2 pulses / 10 cents = 3 / 20 cents = 4 / 50 cents = 5 / 10 euros = 6 / 2 euros = 7
• Set with ADD (or MINUS) to 2 pulses (for 5 cents) and then press SET
• The last thing on the display is F1, which stands for the accuracy of the coin detection. The value 8 worked well.
• Use ADD (or MINUS) to set to 8 and then press SET.
• The parameterization for the first coin is now done and the next 5 coins must follow.
• Now the second LED is on and the display shows H2.
• Repeat the same steps for the second coin up to 6 coins.
• When all coins are set, all LEDs flash briefly to confirm and the display shows A again.
• After a short time the display shows 0 (zero) again.

2.3 Calibrating the coin selector with coins

• Press the SET key twice
• The first LED light and A1 appear in the display
• Now insert the first coin (5 cents) 20 times.
• It is advisable to use as many different coins of the same type as possible.
• After that all LEDs will flash and the display will show A2.
• Repeat the procedure for the remaining coins
• All LEDs flash again briefly for confirmation and the display shows 0 (zero) again.
• The coin selector is now ready.

2.4 Wiring the hardware

• Wire the hardware according to the plan (see pictures), but do not yet install the ATM in the housing.
• Set switch on the e-Paper Display HAT to A and 0
• Be careful when plugging in the fine display ribbon cable!
• The clamp has a small lock which must be loosened before. See picture!

3. create SD card and write WLAN data to it

3.1 Write the Raspberry Pi image to SD card

• Downloaded the image from raspberrypi.org Archive
• The image "2023-05-03-raspios-bullseye-armhf.img.xz" works for sure. I had problems with a newer version, so better stay with the 2023-05-03 one 😉.
• Writing a SD card image with Balena Etcher
• https://www.balena.io/etcher/
• Remove the SD card and put it aside

3.2 Preparing WLAN for the Raspberry Pi

Create a file named wpa_supplicant.conf with the following content:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=DE

network={
    ssid="Home"
    scan_ssid=1
    psk="XXXXXXXXXXXX"
    id_str="Home"
}

network={
    ssid="Mobil"
    scan_ssid=1
    psk="12345678"
    id_str="Mobil"
}

• The file contains two wireless network. The Home is for at home and the Mobile for on the road.
• You can e.g. set up a hotspot on the cell phone and is with the ATM thus also mobile.
• Adjust the values for SSID and PSK as you like.
• Set the country code ISO-3166-1, you are not already in Germany = DE.
• If needed, more networks can be added
• Make sure that the file ends with .conf and not with .conf.txt.
• Windows by default has a habit of hiding known file type endings.
• See "Folder options/View/Advanced settings" -> "Extensions for known file types". -> "Hide extensions for known file types" must be deselected!

3.3 Preparing the freshly flashed SD card

The SD card must now be loaded with three files.

1.) With the WLAN configuration file "wpa_supplicant.conf" that you just created.

2.) With a simple file which is only called "SSH" (not "SSH.txt"!). With this file you will get later access to your Raspberry Pi via SSH connection, i.e. connection via Wifi with command line.

3) Create a file named "userconf.txt" and fill it with:

pi:$6$gUTh.xbNW9Ascyjs$xM4whEiad2GXu3wffSDgb8W77Zgv6BWENQ226goAF93ltX.bOJOktLqOLouaO0/SW5jKye10HjOGH6Y/5.VF90

With this file you tell the new Raspberry Pi image that you want to create a user "pi" with the password "raspberry". The characters behind the pi:. look a bit strange. This is because it is the hash of the password "raspberry". Only the hash is stored on the Pi, this ensures that if the Raspberry is ever compromised, the password is not visible in plain text. For more information see here.

Now put the freshly flashed SD card back into your computer and a new drive should appear called "bootfs". This is the boot drive from which the Raspberry Pi will boot later. The three files help to reinitialize the Raspberry Pi at the first boot. Without them you would have no wifi, no SSH access and no user "pi" with the password "raspberry".

Now you can remove the SD card from the drive.

Note: After the first start of the Raspberry Pi the three files disappear from the directory. So don’t be surprised.

You can also change the wlan configuration file later with the command line:

    $ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf

5. set up and test display

5.1 Download and install display software

$ cd ~
$ git clone https://github.com/waveshare/e-Paper    
$ cd ~/e-paper/RaspberryPi*/python
$ sudo python3 setup.py install

5.2 Testing the display

$ cd ~
$ cd e-Paper/RaspberryPi_JetsonNano/python/examples
$ sudo python3 ./epd_2in13_V2_test.py

If everything is connected and installed correctly, the display will now show a demonstration and then clear the screen again.

Attention: If you have another display type, then you have to use another test function than "epd_2in13_V2_test.py". E.g. "epd_2in13_V3_test.py" for the new version, see the backside of the display. Or "epd_2in13d_test.py", for the flexible (gold colored) (D-)version.

6. settings via config.ini

In the config.ini basic settings are made.

• New login to your Raspberry Pi via CLI: ssh pi@192.168.x.x

6.1 Start ATM once to generate the config.ini

$ cd ~/LightningATM/
$ ./app.py

• At the first start the message No display configuration matched. Exiting... will appear, because you haven’t specified a suitable display yet. So you can ignore it. The config.ini we need now was created in the background.
• Now please edit the config.ini as described below

6.2 Open the config.ini file

$ nano ~/.lightningATM/config.ini

• Don’t be surprised, the spelling is really ~/.lightningATM/config.ini with dot and lower case

6.3 Setting the config.ini file

Under [atm] specify display type

    display = waveshare2in13v2

Note:` Please compare the display type. Yours may require different settings.

delay time (set from 0 to 12 seconds. 0 is only for ATM with push button)

    payoutdelay = 12 

Activate wallet types

    activewallet = lnbits

• Note: A quick guide on how to set up a LNbits wallet can be found here: Quick guide on how to set up an LNbits

Under [lnbits] enter the data for the interface to the LNbits Wallet

[lnbits]
# api credentials
url = https://legend.lnbits.com/api/v1
apikey = YourAdminKey
# One of "invoice" or "lnurlw"
method = lnurlw
# only for lnurlw - seconds to redeem the lnurlw
timeout = 90

Note: Here you only need to specify the apikey = Admin key. You get this from the LNbits Wallet, e.g. Admin key = apikey = 8682516eaf0c457…

Image: Example LNbits Wallet. You only have to activate the extension LNURLw (-> ENABLE).

Note: If you just want to replace the obsolete LNTXBOT wallet with an LNbits wallet for an existing ATM, you will need to take a few more steps. Check out the to this tutorial on the orignal Github.

Set the coins to the pulses.

[coins]
# pulse_count, fiat value, name
coin_types = 2,0.05,5 eur cent
             3,0.10,10 eur cent
             4,0.20,20 eur cent
             5,0.50,50 eur cent
             6.1.00,1 eur
             7,2.00,2 eur

• To save and exit the editor: ‘CTRL+x -> y -> ENTER’.

Test the settings (or the whole ATM) once

$ cd ~/LightningATM/
$ ./app.py

• The display should now show LightningATM.
• If everything is correct, the ATM should be ready for use now.
• Best is to test it with a few cents
• If it doesnt work, later comes the chapter withtmux`. There you can make a diagnosis
• To stop the ATM just press STRG+C.
• After a short time Manually Interrupted is shown and you can see on the display that the ATM turned off.

8. Autostart

Aktivieren:

$ cd ~/LightningATM
$ sudo cp LightningATM.service /etc/systemd/system/LightningATM.service
$ sudo systemctl enable LightningATM.service
$ sudo reboot

Weitere Befehle zur Kontrolle des Dienstes:

$ sudo systemctl status LightningATM.service
$ sudo systemctl stop LightningATM.service
$ sudo systemctl start LightningATM.service

9. extension LED button and locking relay

LED button

A LED button enriches the ATM immensely. It makes many more functions possible. It makes the operation more comfortable and looks also quite good. Here I have put together a construction set, so that you do not even have to solder and everything is easily pluggable. Have a look at my separate page: LED-Button-CSet

Locking relay (electromagnetic gate).

The electromagnetic gate is a locking pin that diverts coins to the ejector. When the coin selector is de-energized, the pin always remains locked and ejects all coins. Only when the correct coin is detected is the locking pin retracted by a solenoid. Only then do the coins fall into the fiat hell. This electromagnetic gate can be controlled or blocked from the outside. The function can be used to exclude multiple pulses (when coins are inserted quickly one after the other) or coin insertion over a certain period of time (a display state or when AMT is offline).

If you want to know more about the lockout relay, on the GitHub page I wrote detailed documentation (English) about it. lock relay

10. well done, that’s it!

• I hope it worked and everything works 🙂
• You can get more help in the Telegram group: https://t.me/lightningatm_building
• If you still find errors in the documentation, or have other suggestions, you can reach me at:
• Telegram: @AxelHamburch
• Twitter: @AxelHamburch

11. a few more tips

• When entering data in the Command Line Interface (CLI), it is best to transfer the commands using Copy & Past: -> To do this, copy the command to the clipboard with STRG+C and then point to the blinking cursor in the CLI window and press the right mouse button to paste the clipboard into the CLI.
• You will find tooltips to the images when viewing them with the desktop version of the website. Point to the images.
• Or if you download the zip file of the images, you will see the names of the images.
• If you get the error bash: $: command not found, then you have copied the dollar sign $ in front of the command.
• If you get the error bash: cd: too many arguments, you may have to go back one level with $ cd ~.
• When logging in via SSH, make sure to use the correct user pi. If you use admin by mistake, you will not get an error, but the password will not be accepted.
• You can change WLAN parameters later with the command:
• $ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf
• If it asks you for a user and password when cloning a repository, reboot the PC + Raspberry Pi once. At least it worked for me.
• SSH login problems with Windows: Check if OpenSSH client AND OpenSSH server is installed under Settings / Apps / Apps & Features or Optional Features.
• If you are not so fit with the CLI and the Raspberry Pi, I recommend to start with a smaller project, for example the BTC-Ticker.
• One more note: I try to keep this German tutorial up to date. But my priority is currently the English Github version. So if something is not quite clear, please check it here.