Lamassu Software for Genmega

First notes

This is a release candidate of our software for the Genmega platform for testing purposes. Please get a feel for it and let us know what you need and any feedback you have.

We have disk images compatible with the Universal Kiosk 1, Universal Kiosk 2, Gemini, and Wall Kiosk, though some models differ and may need changes for the display and detection of the barcode scanner. Any fine tuning for your models we'll be happy to make.

Creating the disk image

Please use a 32 GB USB 3.0 flash drive or larger. After downloading the .img.xz file, use balenaEtcher to burn it to the USB drive. (There is no need to decompress the image from .xz as balenaEtcher will do this for you.)

Booting from the drive

There's a spare USB 3.0 port on the back of the Universal Kiosk's computer. Plug the drive into that, and a USB keyboard into another spare port.

When powering up, press the DEL button until you see the BIOS screen. Once there, navigate to the 'Boot' tab, and under the boot priorities, choose 'UEFI Kensington USB' (or similar) for the first option, and for the second option, any other selection mentioning USB or Ubuntu. Disable any options indicating the internal hard drive.

In the BIOS, choose 'Save and exit'. It should then go to a Xubuntu bootup screen, then to a Xubuntu desktop and then a Lamassu screen.

Preparing the machine for cash-out

If this is a two-way machine, we'll need to specify two values on a file on the drive in order to enable cash-out

For this, you'll need the license key of the cash dispenser unit (CDU). This is included on a piece of paper inside Genmega's getting started box. It should be in a format similar to 8A2278ABCD6D3F4.

With this, open up a terminal on the machine with Ctrl+Alt+T. Run sudo su, hitting Enter, then the password provided by our support team, hit Enter, then run:

nano /opt/lamassu-machine/device_config.json

Using the arrow keys, navigate to the billDispenser section at the end. Here, add the license key in the license field, and the number of CDU cassettes in the cassettes field, as below:

"billDispenser": {
    "model": "genmega",
    "device": "/dev/ttyS3",
    "license": "8A2278ABCD6D3F4",
    "cassettes": 3,
    "_mockedError": {
      "0x51": [0, 4]
    }

Save with Ctrl+X, then Y, then Enter. In the terminal, run:

supervisorctl restart lamassu-machine

You can then close the terminal window with Alt+F4, or Alt+Tab back to the Lamassu UI.

Accessing the admin

Log into your Lamassu Admin that you've created following the steps here:

https://support.lamassu.is/hc/en-us/sections/360001713031-Admin-Setup-Step-by-Step

Or you may have been provided a link to a demo admin of ours for testing purposes.

Pairing the machine

Within your Lamassu Admin, use the 'Add machine' button in the upper-right of the dashboard to name your machine and generate a pairing code. Take a picture with your phone, leaving enough white space around the QR code.

On the machine, press the 'INIT' button on screen. It will then change to a 'Scan' button on the pairing screen. Press 'Scan', and hold up the QR code to the kiosk's barcode scanner. You should see it go to 'Booting up' and then to the 'Buy Bitcoin' home screen.

Next steps

Explore the Admin and machine flows as you wish, the features of which you may find detailed in our knowledgebase, including a summary of its compliance features.

In the admin, the coin wallets are set to mock crypto transactions, so you do not need to top up the admin's wallets to go through a transaction flow.

Please let us know any questions or if we can demonstrate features of the admin or machine. Thanks!