diff --git a/README.md b/README.md new file mode 100644 index 0000000..f07d062 --- /dev/null +++ b/README.md @@ -0,0 +1,53 @@ +# TTN Gateway for Raspberry Pi + IMST iC880A SPI + +Resin Dockerfile & scripts for [The Things Network](http://thethingsnetwork.org/) gateways based on the iC880a concentrator with a Raspberry Pi host, connected using SPI. + +## Using this with Resin + +- Download [Raspbian Jessie](https://www.raspberrypi.org/downloads/) +- Follow the [installation instruction](https://www.raspberrypi.org/documentation/installation/installing-images/README.md) to create the SD card +- Start your RPi connected to Ethernet +- Plug the iC880a (**WARNING**: first power plug to the wall socket, then to the gateway DC jack, and ONLY THEN USB to RPi!) +- From a computer in the same LAN, `ssh` into the RPi using the default hostname: + + local $ ssh pi@raspberrypi.local + +- Disable graphical boot mode and reboot: + + $ sudo raspi-config + +- Configure locales and time zone: + + $ sudo dpkg-reconfigure locales + $ sudo dpkg-reconfigure tzdata + +- Remove desktop-related packages: + + $ sudo apt-get install deborphan + $ sudo apt-get autoremove --purge libx11-.* lxde-.* raspberrypi-artwork xkb-data omxplayer penguinspuzzle sgml-base xml-core alsa-.* cifs-.* samba-.* fonts-.* desktop-* gnome-.* + $ sudo apt-get autoremove --purge $(deborphan) + $ sudo apt-get autoremove --purge + $ sudo apt-get autoclean + $ sudo apt-get update + +- Create new user for TTN and add it to sudoers + + $ sudo adduser ttn + $ sudo adduser ttn sudo + +- Logout and login as `ttn` and remove the default `pi` user + + $ sudo userdel -rf pi + +- Clone the installer and start the installation + + $ git clone https://github.com/ttn-zh/ic880a-gateway.git ~/ic880a-gateway + $ cd ~/ic880a-gateway + $ sudo ./install.sh + + +# Credits + +These scripts are largely based on the work of: +[Gonzalo Casas](https://github.com/gonzalocasas] on the [iC880a-based gateway](https://github.com/ttn-zh/ic880a-gateway/tree/spi) +[Ruud Vlaming](https://github.com/devlaam) on the [Lorank8 installer](https://github.com/Ideetron/Lorank) \ No newline at end of file