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 [email protected]
  

• 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

⚠️ 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.