background image

iC880A-SPI QuickStart Guide - QuickStart Guide 
Open Source Driver on Github 

confidential  

iC880A-SPI_QuickStartGuide.docx, Wireless Solutions, V0.1 

page 9 of 17 

 

configuration. Changes / updates within all relevant software repositories are subject to change 

without notice. 

2.1

 

Download of the Open Source Driver 

Install a git client on your (embedded) host system: On Debian based systems the git client can 

be installed by calling the following command in a terminal emulator / console: 

 
sudo apt-get install git 

Create local folder that should contain the local copy of the repository: 

mkdir -p ~/LoRa/lora_gateway

 

Get a copy of the repository: 

cd ~/LoRa/lora_gateway 

git clone 

https://github.com/Lora-net/lora_gateway.git

 

2.2

 

Preparing the host system (Raspberry Pi) 

2.2.1

 

Preparing the SPI Interface 

The github open source driver (in version 3.2 and newer) requires a “native” SPI interface of the 

host  system  to  be  present.  This  is  by  default  called  “/dev/spidev0.0”.  In  order  to  use  this 

interface, it must be enabled on the Raspberry Pi platform. To enable it the user must call the 

following  command  in a  terminal  emulator  /  console  of  the  Raspberry  Pi  running  the  Debian 

based Rasbian distribution: 

sudo raspi-config 

A text based menu will appear and the user has to enter the “Advanced Options” sub menu. 

Next the entry “SPI” has to be chosen and the following two questions have to be answered with 

the “Yes” option. After a reboot of the system the SPI interface is ready to be used. 

2.2.2

 

Preparing the Reset Pin Control 

Now  that  the  SPI  interface  is  accessible,  the  control  logic  for  the  reset  pin  has  to  be  set  up. 

During the development history of the LoRa driver, the support for GPIO pin control has been 

removed  from  the  sources.  (Note:  the  repository  is  not  maintained  by  IMST.)  That  means  the 

user  has  to  take  care  of  it  via  an  additional  piece  of  software.  In  general  there  are  two 

possibilities to control the GPIO pin that is connected to the Reset pin of the iC880A-SPI. 

Summary of Contents for iC880A-SPI

Page 1: ...iC880A SPI QuickStart Guide How to get started with the iC880A SPI Document ID 4100 40140 0096 Category confidential IMST GmbH Carl Friedrich Gauss Str 2 4 D 47475 Kamp Lintfort...

Page 2: ...x Created 2015 03 15 Total pages 17 Revision History Version Description 0 1 Preliminary version Aim of this Document Aim of this document is to give some quick start instructions how to start working...

Page 3: ...in Headers 6 2 OPEN SOURCE DRIVER ON GITHUB 8 2 1 Download of the Open Source Driver 9 2 2 Preparing the host system Raspberry Pi 9 2 2 1 Preparing the SPI Interface 9 2 2 2 Preparing the Reset Pin Co...

Page 4: ...rdware PCB Figure 1 1 depicts the printed circuit board of the iC880A SPI As main interface there are the pin headers for connecting the board to a host system that runs the driver software A SMA conn...

Page 5: ...e concrete segmentation of the protocol related tasks is outside the scope of this document Figure 1 2 Basic System Concept 1 3 Linux Host System As a host system an embedded Linux host system is plan...

Page 6: ...system keyboard layout time zone network connectivity accessibility is outside of the scope of this document too 1 4 Hardware Connection The iC880A SPI provides SPI pin headers as main interface to th...

Page 7: ...1 GPIO 2 3 4 5 V 9 SCL1 GPIO 3 5 6 GND 7 GPIO_GCLK GPIO 4 7 8 GPIO 14 TXD0 15 GND 9 10 GPIO 15 RXD0 16 0 GPIO_GEN0 GPIO 17 11 12 GPIO 18 GPIO_GEN1 1 2 GPIO_GEN2 GPIO 27 13 14 GND 3 GPIO_GEN3 GPIO 22 1...

Page 8: ...t and the iC880A SPI Figure 1 3 Connection variants between Host and iC880A SPI It is recommended to connect the necessary signals using wires that are as short possible in order to prevent communicat...

Page 9: ...the host system to be present This is by default called dev spidev0 0 In order to use this interface it must be enabled on the Raspberry Pi platform To enable it the user must call the following comma...

Page 10: ...iC880 SPI_reset sh The user must call this script once after every boot up in order to get the concentrator IC in a clean state 2 2 2 1 2 Possibility B Control the GPIO pin via a compiled C Tool libr...

Page 11: ...ing values prior re compiling the library DEBUG_AUX 0 DEBUG_SPI 0 DEBUG_REG 0 DEBUG_HAL 1 DEBUG_GPS 0 These flags are used by the internal modules of the library to enable disable additional output fo...

Page 12: ...ber 3 OK Each time a new packet is being transmitted the TX LED of the iC880A SPI should flash The tool can be stopped by pressing the key combination Ctrl C For more information about this tool pleas...

Page 13: ...le there are some general settings concerning the private public LoRa network setup The setting for the internal clock must not be changed Next there is one config block for each radio of the concentr...

Page 14: ...ublic true than the peer has to send packets that are compliant to public LoRaWAN networks This can be archived by using the Software called WiMOD LoRaWAN EndNode Studio in combination with a WiMOD mo...

Page 15: ...ion As a final hint there are some more interesting open source projects within the gitbub repository https github com Lora net For example there is a project called packet_forwarder that demonstrates...

Page 16: ...h essential requirements of the R TTE directive is within the responsibility of the manufacturer of the final product A declaration of conformity for the radio module is available from IMST GmbH on re...

Page 17: ...compliance of systems or units in which products from IMST GmbH are integrated with applicable legal regulations Customers should provide adequate design and operating safeguards to minimize the risk...

Reviews: