first commit

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)