The Things Network: iC880a-based gateway

Reference setup for The Things Network gateways based on the iC880a USB concentrator with a Raspberry Pi host.

This installer targets the USB version of the board, if you have the SPI version, check this branch.

Setup based on Raspbian image

• Download Raspbian Jessie Lite

• Follow the installation instruction 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

• Default password of a plain-vanilla RASPBIAN install for user pi is raspberry

• Use raspi-config utility to expand the filesystem (1 Expand filesystem):

  $ sudo raspi-config

• Reboot

• Configure locales and time zone:

  $ sudo dpkg-reconfigure locales
  $ sudo dpkg-reconfigure tzdata

• Make sure you have an updated installation and install git:

  $ sudo apt-get update
  $ sudo apt-get upgrade
  $ sudo apt-get install git

• Create new user for TTN and add it to sudoers

  $ sudo adduser ttn 
  $ sudo adduser ttn sudo

• To prevent the system asking root password regularly, add TTN user in sudoers file

  $ sudo visudo

Add the line ttn ALL=(ALL) NOPASSWD: ALL

:warning: Beware this allows a connected console with the ttn user to issue any commands on your system, without any password control. This step is completely optional and remains your decision.

• Logout and login as ttn and remove the default pi user

  $ sudo userdel -rf pi

• Configure the wifi credentials (check here for additional details)

  $ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf 

And add the following block at the end of the file, replacing SSID and password to match your network:

            network={
                ssid="The_SSID_of_your_wifi"
                psk="Your_wifi_password"
            }

• 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

• If you want to use the remote configuration option, please make sure you have created a JSON file named as your gateway EUI (e.g. B827EBFFFE7B80CD.json) in the Gateway Remote Config repository.

• Big Success! You should now have a running gateway in front of you!

Credits

These scripts are largely based on the awesome work by Ruud Vlaming on the Lorank8 installer.