Skip to content
WASN LoRaWan Devices Getting Started Guide
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Configurator Configurator 6.4: some small bugfixes, little design change Feb 17, 2020
Decoder Configurator 6.3: bugfixes Feb 15, 2020
Firmware Firmware 2.0.9 Feb 3, 2020
Manuals beta Jan 18, 2020
images new TTN decoder Feb 15, 2020
.gitignore Configurator 6.0: with integrated cubecell database Feb 8, 2020
Getting Started Guide.pdf
README.md added decoder for chirpstack Feb 15, 2020

README.md

ModularNode & IndoorNode

Getting Started Guide

(c) by

Connecting the Indoor/ModularNode or a Cubell to your computer
Choosing the right firmware version
Use CubeCell Configurator to upload firmware
Use CubeCell Configurator for configuration
Use the CubeCell Database
The Things Network decoder
Connecting a sensor
Connecting a battery to the CubeCell Capsule
RGB LED
Known AT Commands

You need to use Configurator version 5.0 or above, all older version will nor work anymore.

Connecting the Indoor/ModularNode or CubeCell to your Computer

  • connect the USB board to the capsule

  • the white dot on the USB board must align with the white dot on the capsule (beside the Reset button)

  • connect the micro USB of the USB board to your computer

If you have a Indoor/ModularNode or CubeCell board just connect the micro USB to your computer

The drivers for the Silabs CP210x USB to serial adapter should be installed automatically via windows update. If not you can download it here.

Choosing the right firmware version

Before flashing the firmware you have to choose the firmware type. You have to choose between IndoorNode, ModularNode, Board, Capsule, TCA9548A.

Here is a comparison of these types:

Type IIC OneWire TCA9548A Sensor Auto Scan Comments
IndoorNode X only BME280/BME680 special for WASN IndoorNode
ModularNode X X X all sensors listet below special for WASN ModularNode
Board X X all sensors listet below
Capsule X all sensors listet below
TCA9548A X X X all sensors listet below
Mapper special for WASN Mapper

These sensors are supported:

  • ADS1015/ADS1115
  • BH1750
  • BME680
  • BME280
  • BMP180
  • BMP280
  • CCS811
  • HDC1080
  • MPU9250
  • SHT2x
  • VL53L1X

Use CubeCell Configurator to upload firmware

The easy way to get the Capsule up and running is:

  • Download the CubeCell Configurator from here download.
  • Open the CubeCell Configurator
    • Select the Flash Tab

  • just skip the next 3 steps to download the firmware from the online catalog
    • click check to see what version is online and what version in in your offline catalog
    • click update to update the offline catalog with the newest online version
    • to use the offline catalog activate the checkbox "use offline Firmware catalog"
  • Select the right COM port (if you would like to preserve configuration click connect, else not)
    • Select the Node Type (IndoorNode, ModularNode, Board, Capsule, TCA9548A)
    • Select the right frequency band (EU868, US915, AU915)
    • Select RGB LED Status (on, off)
    • click Flash Firmware

  • If you have clicked on connect in the first step, you will see a checkbox with the option to preserve configuration, else this checkbox is not shown

    • Click on Flash Firmware to start the process
    • Firmware is now downloaded from github.
    • The firmware will be written to the capsule
    • If you have selected to preserve configuration, the configuration is saved to the CubeCell
    • The debug text box shows the state of the firmware download and flash.
  • If an error happens this will be in the debug text box too.

          Downloading Firmware …
          Downloading Firmware done
          Flashing Firmware …
          PROCESS PERCENTAGE
          Flashing Firmware done
          CleanUp Starting
          CleanUp done
    

The firmware has the following config:

  • REGION: (selectable)
    • EU868
    • US915
    • AU915
    • IN865
  • CLASS_A
  • OTAA
  • ADR: ON
  • Net_Reservation: OFF
  • AT_SUPPORT: ON
  • RGB: (selectable)
    • ACTIVE
    • DEACTIVE
  • unconfirmed uplink
  • All Keys set to zero

The firmware auto detects the connected I2C sensor.
You can connect more than one sensor to the I2C bus.
The only limitation is, that you can connect only 1 sensor of each modell on each sensor socket.

If you have a TCA9548A I2C Switch conncted to the I2C Bus, Vext and GND you can connect up to 8 sensors of each model to each switch output. You need to flash the TCA9548A firmware to activate the use of the TCA9548A I2C switch.

The IndoorNode and ModularNode Firmware is only for our Nodes. This Firmwares will not work on other hardware.

OneWire Sensors will be supported on GPIO1. Right now the CubeCell hangs sometimes with activated OneWire.

Use CubeCell Configurator for configuration

  • Login to TTN and create an application if you haven’t already.
  • Under your application create a device for the CubeCell device you are setting up
  • Open the CubeCell Configurator

  • Select your COM Port and click connect.

  • Select the Config Tab

    • all EUIs, Keys, \auth type and DutyCycle are read from the CubeCell device.
    • Choose the authentification type (OTAA is default).
    • copy the keys:
      • for OTAA auth: Device EUI, Application EUI and App Key
      • for ABP auth: Device EUI, Application EU, Device Address, Network Session Key and App Session Key
    • Please note that you should copy and paste only one key at a time. On TTN you will notice that there is a Copy icon at the end of each key field. Then back in the Configurator screen just paste each value you copied from the TTN device screen
    • Set a Dutycycle (Sleeptime between 2 sends).
    • by default all uplinks are unconfirmed, if you need confirmed uplinks please enable the TX confirmed checkbox
    • Click on Write.
    • to save the data to the database click on save in the CubeCell Database area.
  • The keys will be saved in the CubeCell device and the device will reboot

  • In the debug text box you should see the following:

    AT+DevEui=YOURDEVEUI
    AT+AppEui=YOURAPPEUI
    AT+AppKey=YOURAPPKEY
    AT+DutyCycle=YOURDUTYCYCLEINMS
    AT+RESET=1
    ...
    ...
    joining...
    joined
    
  • Now you should see the Join Requests in your TTN Application and short after that data comming in.

Use the CubeCell Database

Search for the dataset you would like to use for the connected CubeCell and click on use. The data can than be written to the CubeCell by clicking on write in the config tab.

The Things Network decoder

  • Login to TTN and go to your application you have previously defined the device in.
  • Now you can define the decoder for this application.
  • The decoder can be downloaded from here download.

Connecting a sensor

If you have bought the IndoorNode (buy) there is a BME280 or BME680 sensor fitted in the case.

If you have bought the ModularNode (buy) you can connect the sensor to one of the 3 sockets.

If you have bought a sensor from our Website (buy) or from Heltec then you can just plug it in the capsule./p>

If not here is the pinout for connecting your sensor:

  • Vext is used for powering the sensors. This pin only delivers power to the sensor when taking the measurement.
  • use VS and GND to connect a solar panel (5.5 - 7V).

You can connect more than one sensor to the I2C bus.
The only limitation is, that you can connect only 1 sensor of each modell on each sensor socket.

If you have a TCA9548A I2C Switch conncted to the I2C Bus, Vext and GND you can connect up to 8 sensors of each model to each switch output. You need to flash the ModularNode firmware to activate the use of the TCA9548A I2C switch.

OneWire Sensors will be supported on GPIO1. Right now the CubeCell hangs sometimes with activated OneWire.

You can check which sensor the CubeCell device has found:

  • Open the CubeCell Configurator

  • Select your COM Port and click connect.
  • Click the Reset button.
  • you should see a message with the name of your sensor:
Copyright @ 2019 Heltec Automation.All rights reserved.
Sensor Port Scanning...
  Found BME680
  Found MPU9250
...
  • Or if you have the I2C Switch installed you will see the Port number and name of the sensor:
Copyright @ 2019 Heltec Automation.All rights reserved.
Sensor Port Scanning...
  Port 0
    Found BME680
  Port 1
    Found MPU9250
...

Connecting a battery to the CubeCell Capsule

This battery fits nicely in the capsule (buy)

If you have bought the Capsule from us (buy) there is a battery connector installed.

RGB LED

  • RGB red means sending;
  • RGB purple means joined done;
  • RGB blue means RxWindow1;
  • RGB yellow means RxWindow2;
  • RGB green means received done;

Known AT Commands

This are the common AT commands. A full list can be found in this PDF

AT Command              | Value                        
------------------------+-------------------------------------------------------------------------
+LORAWAN=1              | LoRaWAN  1, LoRa 0
+OTAA=1                 | OTAA -1, ABP-0  
+Class=A                | Class A or C  
+ADR=1                  | 1 on 0 for off  
+IsTxConfirmed=1        | LoRaWAN ACK Message 1 on, 0 off.  
+AppPort=2              | The Application Port 2 for general APPs and 10 for TTN MAPPER.  
+DutyCycle=60000        | The time between transmission in mS. Typically, 15000 to 3600000  
+ConfirmedNbTrials=8    | The number of adaptive rate changes allowed.  
+DevEui=???             | Unique (OTAA Mode) 
+AppEui=???             | Unique (OTAA Mode)
+AppKey=???             | Unique (OTAA Mode)  
+NwkSKey=???            | Unique (ABP Mode)
+Passkey=???            | Unique (ABP Mode)
+DevAddr=???            | Unique (ABP Mode) 
+LPM=1  	        | Low Power Mode
+ChipID=?	        | get ChipID
+JOIN=1	                | start join
+DelCDKEY=1 	        | to delete the CDKEY
+DefaultSet=1           | to reset parameter to Default setting
You can’t perform that action at this time.