Introduction

This is the documentation for Bleskomat devices.

Bleskomat Platform

Each Bleskomat ATM comes with a new user account for the Bleskomat Platform. From the time you first login to your account, you are granted access to the platform for a limited-time free trial period. Instructions and credentials for accessing your Bleskomat Platform account were provided to you along with your Bleskomat ATM. To login to your account for the first time, visit the following web page: https://www.bleskomat.com/start

Features of the Bleskomat Platform

• Support for several LN service providers
• Remotely manage your ATM’s configurations
• View statistics and monitor your ATM
• Receive email alerts regarding funding or other issues

No Vendor Lock-in

You are not locked-in to our platform. We provide a free and open-source version of the platform that you can run on your own hardware or cloud infrastructure. Additional details including a list of features, setup guide, and other documentation can be found in the publicly available repository: https://github.com/samotari/bleskomat-server

Getting started

The Bleskomat Bills and Coins ATM are the next generation Bitcoin ATM which utilizes the Lightning Network to achieve near-instant, low-fee bitcoin payments. With its unique combination of features, even customers with little to no experience can buy (and spend!) their very first bitcoin in under a minute.

Bleskomat Bills ATM

Bleskomat Coins ATM

Bleskomat Bills ATM

Once you receive Your Bleskomat Bills it should be fully functional but it is not configured to any Bleskomat account so if you try to scan the QR codes produced by the device they will give you an error.

In order to configure the device to be fully functional you need to either use the Bleskomat Platform, have your own Bleskomat Server or run it with some of the integrations we have done with other projects like LNBits or Umbrel. Here we are going to explain how to do it with Bleskomat Platform.

Platform configuration

In Bleskomat Platform go to Devices > Device Settings

• Reference Phrase - Two random words from Bip39 list used to identify the device.
• Device Type - What Bleskomat device you are configuring.
• Fiat Currency - The fiat currency that the device is going to accept. It requires hardware configuration so it is not possible to only change it here and make it work.
• Exchange Rates - The provider used for the exchange rate that will be done at the moment for each trade.
• Fee Percent (%) - Percentage of the fee that will be applied to every trade. This is how you make money.
• Fixed Fee - A fixed fee denominated in the fiat currency of the device. This is how you make money.
• Custom Invoice Memo Prefix - If set, this will replace the default invoice memo prefix - e.g. Bleskomat (absurd cake). Your ATM customers will see this in the memo field of their wallet application's invoice.

Preparing board for hardware configuration

The only think you need, is to take the Bleskomat Board from the case and connect it with USB to your computer using the CP2101 connector that was provided with your device.

You have to make sure that Bleskomat Board switch is set to "Firmware" so we can configure it.

Hardware Configuration from Bleskomat Platform

Once you have the board out of the box you connect it to your computer with USB and the Bleskomat Platform will manage the configurations for you.

• If you are on Windows you should install driver https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads and download the file with name "CP210x Windows Drivers".
• If you are on Linux probably you will have to give permissions to your user to access USB running the command: "sudo chown ${USER}:${USER} /dev/ttyUSB0"

In the Bleskomat board there are 2 buttons (Boot and Flash). You will be asked to push those buttons during firmware update as it follows:

• Keep "FLASH" button pressed while you pressed and release "BOOT" button. Once the Firmware updated has concluded you should press "BOOT" button alone.

Bellow you can see a vide of how it goes:

Bleskomat Coins ATM

Platform configuration

In Bleskomat Platform go to Devices > Device Settings

Preparing board for hardware configuration

The only think you need, is to take the Bleskomat Board from the case and connect it with USB to your computer using the CP2101 connector that was provided with your device.

• Disassembling the Bleskomat Board

• Connecting Bleskomat Board to your computer with provided CP2101

You have to make sure that Bleskomat Board switch is set to "Firmware" so we can configure it.

Hardware configuration from Bleskomat Platform

Once you have the board out of the box you connect it to your computer with USB and the Bleskomat Platform will manage the configurations for you.

• If you are on Windows you should install driver https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads and download the file with name "CP210x Windows Drivers".
• If you are on Linux probably you will have to give permissions to your user to access USB running the command: "sudo chown ${USER}:${USER} /dev/ttyUSB0"

In the Bleskomat board there are 2 buttons (Boot and Flash). You will be asked to push those buttons during firmware update as it follows:

• Keep "FLASH" button pressed while you pressed and release "BOOT" button. Once the Firmware updated has concluded you should press "BOOT" button alone.

Steps:

1. Connect Bleskomat board to CP2101 provided
2. Make sure that the switch in the Bleskomat Board is set to "FIRMWARE"
3. Connect Bleskomat board to your computer USB
4. Open a supported browser (Google Chrome) with your platform account and go to Devices > Device Settings > Hardware configuration
5. Click on "Connect" and the browser should
6. You should see the message "Detecting Firmware"
7. Once "Detecting Firmware" is completed it will ask you to "Update Firmware"
8. After clicking on "Update Firmware" then in Bleskomat Board keep Button "FLASH" pressed while you press "BOOT" and it will trigger update.
9. One the Firmware update is completed it will try to reconnect to device. When you see the message "Reconnecting to device..." then in Bleskomat Board press "BOOT" button.
10. You should now see "Restarting Device" until you see "Done!"
11. You are done here!
12. Before assembling the board back to device make sure the switch in the board is set to PWR

The above described steps are display in the video below for clarification:

Training Coin acceptor to whatever currency you want

For now we are shipping all Bleskomat coins configured by default for Euro coins. But you can train it for every currency you want.

Video coming soon!

1. Access To Coin Parameters Setting Keep pressing button A till CP is displayed. LED displays CP , press button A to select one of six groups of coins.

2. Clean Up All Coin Parameters When it displays CP , keep pressing button B till CC is displayed, it will clean up all six groups of coin parameters .

3. Add New Coin Parameters When it displays CP , press button A to select the needed coin group （C1~C6）, then press button B to displays the current coin value stored , deposit coins needed (it prompts "bi" each time deposit a coin), when it prompts “bi.bi.bi”and displays F ,it means this group is fully stored and don't need to add coins anymore.

   The coin values should go from 1 to 6 being 1 the smallest denomination you are going to use and 6 the biggest. For example for Euro coins: 1 - 0.05 2 - 0.10 3 - 0.20 4 - 0.50 5 - 1.00 6 - 2.00

4. Exit Coin Parameters Setting After finish coins parameter setting, keep pressing button A for 2 seconds, release after it displays 88.

Support

Bleskomat s.r.o. strives to provide a smooth setup and on-boarding experience to its customers. Please reach out to us via email by contacting support@bleskomat.com with your questions or inquiries. We will do our best to respond within a reasonable amount of time.