Update: October 7th 2015: I no longer sell nor support skyhook ATMs, but will keep this guide available as a reference.
Thank you for purchasing your new SKYHOOK ATM! With this device you will now be able to facilitate easy purchases of bitcoin from your own storefront terminal. Without further adieu, lets begin:
Quick Start Guide as per Skyhook Direct :
1. Power on the 2012 Nexus 7 Tablet.
2. For the Network Connectivity Selection choice, Choose option A or B.
A. Wired Connection – Plug the Ethernet cable directly into the ATM.
B. Drag from the Upper right corner of the screen to Configure Wifi Settings
3. Reboot the Tablet and allow it to load.
4. Plug the tablet into the Raspberry Pi in the Skyhook.
5. Drag down from the Upper right corner and enable tethering.
6. Wait for the device to boot (~ 60 Seconds), then launch Firefox. Holding your finger on the screen will switch it to full-screen mode.
7. Once your skyhook is connected, the Tablet will load the operator configuration panel.
Update Guide for Skyhook ATM:
Warning: Failure to change your password as described below may compromise your ATM security so be sure to change the password after gaining access via SSH.
To update your Skyhook you will need:
- Putty (software that will allow you to connect and use SSH on windows).
- A Linux Live CD to modify the passwords file and allow SSH access
- Win32 Disk Imager (for backing up the image on Windows)
- Access to the internet to ‘git-pull’ the latest Skyhook updates
- Patience
Backing up the current software
1. To start you will want to make a backup of the SD card connected to the raspberry pi. This card has the software that powers the actual skyhook integrates between the bill validator and your bitcoin wallet. To do this, you can use Win 32 Disk Imager. After you plug in your SD card into the computer, Run Win32 Disk Imager, select the drive letter that is assigned to your SD card drive (perhaps your drive letter is G:\).
2. Then click the blue folder button on the upper right side
3. Create a new folder, call it Backups OR navigate to your folder where you plan to store your backups.
4. Write ‘something meaningful’ to name your backup in the filename area – I named my backup “skyhookbkp-9-20-14” then press Open.
5. Click Read to copy save the contents of the SD drive over to the folder mentioned in Step 1
Enabling SSH access for your raspberry pi :
We want to enable SSH access so that we can login to the Raspberry pi and run periodic software updates via the ‘git pull’ command on the /skyhook/ directory periodically. To do this we will be modifying the Raspberry pi passwords file to set the password for the username “pi” which will include sudo privileges (Typing sudo in front of a command is the equivalent to “Run as Administrator”)
1. Grab a LiveCD. There are literally dozens to choose from and most of them are very large in size, so I have included a link to a smaller Linux Distribution (referred to as Distros) called TinyCore Linux. This file is an .ISO file and will need to be burned to a CD or used to load a Virtual Machine.
2. Use a CD Burning software that will allow you to create a Data Disc:Other and select Disc Image. This will create your LiveCD so that it can be used to boot into Linux.
3. If you plan to use the same computer that you are using right now to read this then Print these directions…SERIOUSLY…
4. Restart your PC with the LiveCD inside (if your computer boots directly to the hard drive, then use your Bios settings to set the Boot order, Have your CDRom selected first before your hard drive and be sure to ‘press any key to boot from cd’ upon restart)
5. With the LiveCD booted, insert the SD card used for the Skyhook. Upon Loading it, your Machine will identify it as something like “/dev/sdb1” or perhaps “/dev/sda”. Take note of whatever your SD card has been identified as and use that in step 8 when mounting the SD card to the system.
6. Open Terminal – it will look like a command line interface from DOS, but still be different.
7. Copy the following into your terminal (OR type if you printed this):
sudo mkdir /mnt/skyhook
8. You have created a directory to load the Skyhook files from the SD card into. This is known as “mounting” the device. Now type (Using YOUR name for the SD card given):
sudo mount /dev/sdb2 /mnt/skyhook
9. Once it is mounted correctly, we will want to access the passwords file with:
sudo nano /mnt/skyhook/etc/shadow
10. Notice that this is the passwords file and that there are different machine usernames along with the traditional root and the one we want to modify, the ‘pi’ user. Comment out the existing pi user by placing the # symbol in front of the line.
11. copy the following line into your passwords file, I suggest placing it right below the commented out line:
pi:$6$AGHK.cNv$fD2nQczBgo3F0/8VlS5SV6Qnop4IRN04PGvpdfWkV6w1fTVVw04JNYosmNmhmhTidZnyu817QDLBOCx9bVdiP1:16077:0:99999:7:::
This line was taken from a stock install passwords file of Raspbian, which is a customized version of Debian (another Linux Distro) made for Raspberry Pi.
Your new default password is now: raspberry
12. Save your passwords file by pressing the CTRL key and the X key at the same time. Confirm by pressing Y twice, once for Saving the file and again to confirm overwriting the file.
13. Do not remove the SD card yet!!! Disconnect it first by typing in:
sudo umount /mnt/skyhook
14. It is now safe to remove your card. Plug it back into the Raspberry pi in the ATM, Plug in an Ethernet Cable, and Start up your Skyhook with the Quickstart, using Option B.
15. Remove the CD from your PC and restart the computer into Windows.
16. Using your Router or an IP address Scanner, determine the IP address of your ATM machine.
17. Fire up Putty. Type in the IP address of your ATM into the field that says hostname. So for instance if my IP address found for the Skyhook was 192.168.1.72, My Putty window would look like this:
17. Press Open. Your username is “pi” and your password is “raspberry”. Putty will give you a warning message about the RSA fingerprint being secure. the tl;dr = press okay, you knowingly pointed to the correct IP.
18. Lets change your password NOW (make sure you remember it otherwise you will have to do everything all over from step 1!) to do this, type:
passwd
Updating the Skyhook software
The moment you’ve been waiting for, updating your Skyhook software to recieve the lastest and greatest software updates! Lucky for you, this step is very easy. The prior steps above were required to allow you to easily update your skyhook in the future as more features are rolled out.
1. Using Putty, log into the Skyhook ATM via SSH. (if you are following along, you have already done this step above)
2. Type or Copy/Paste the following into the terminal:
cd /var/www/btc
3. Finally, type:
git pull
4. This command is built-in and uses git, a software revisioning and updating tool used heavily in Linux. It will ask you to confirm file modifications, press Y to continue and update the Skyhook to the latest software update.
And there you have it! This is a step by step guide on how to initialize and update a Skyhook ATM. Special thanks goes out to TKRSRY whose guide was referenced for creating this one, Jon Hannis for guide reference support, and to SoapSuds-Bitcoin for the Setup Guide Directions listed.