...
The following table shows the changes done with every NB | EASY version:
Version | Date | Changes |
---|---|---|
1.4 | 15 Oct 2019 | Special version for the vodafone USB connect LPWA devic |
1.3 | 16 Aug 2018 |
|
1.2 | 06 Jul 2018 |
|
1.1 | 01 May 2018 |
|
1.0 | 11 Apr 2018 |
|
Software Installation
Basic software requirements
...
The required UART driver has been distributed as part of the Linux kernel since v4.4.132.
Check whether the required kernel module is loaded:
lsmod | grep option.
Check whether you have read/write access to the USB-UART bridge:
ls -la /dev/ttyUSB*.
Download the NB | EASY jar-file from the Software & Drivers for Vodafone LPWA Products.
Start the program via the command line:
java -jar Vodafone-NB-EASY-x.x.x.jar.
Device Selection
After starting the application, the Device Selection tab is shown first. Here the to be controlled NB device can be selected.
The Refresh button starts a new search of connected NB devices via COM port5. An ongoing search is indicated by a moving progress bar below the button.
After the search is finished all available device are displayed. By clicking on the NB|DEV KIT, it will be selected for usage. After that the Quick Start tab is shown.
...
Figure 1:Device selection tab
...
The top area of the application shows the selected device and its current state.
Device name and its parameters
Name of selected NB device and its hardware revision
Firmware version installed on the NB device
EASY interface version used by the NB device EASY interface
IMEI: International mobile equipment identity.
Modem Status: shows the current status of the device.
Attach to network: triggers an Attach or Detach of the device depending on the modem status
...
Figure 3 : Device State description
...
The modem status indicates the following states:
Modem Status | Description |
---|---|
PowerOff | The modem is not power on. |
PoweringUp | The modem is currently powering on. |
PoweringDown | The modem is currently powering down. |
Detached | The modem is powered on but not attachted to the network. |
Attaching | The modem is currently trying to attach to the network. |
Attached | The modem is attached to the NB-IoT network |
Detaching | The modem is currently detaching from the network. |
Transmitting | The modem is transmitting data. |
Receiving | The modem is receiving data from the network. |
Figure 4: Modem status description
...
In the detached state, the device is not able to transmit data to the NB-IoT network. First, an attach procedure needs to be triggered, including the following steps:
Select the NB-IoT network in the drop down menu.
Click on the Attach to network button to start the attachment procedure to the selected NB-IoT network
Note: Be aware that the inserted SIM card must correspond to the selected network, otherwise the attach procedure will fail.
...
In the attached state the device is now able to transmit data via the NB-IoT network.
Button to start a transmission to the cloud of the entered text ( 2 in figure 6) as well as the current cell information.
Text field to enter example text to be transmitted when button (1 in figure 6) is pressed.
Button to start a cell information update.
List which shows all received cell information of the last successful cell information update (see Displayed parameters in figure 8 below).
Button to open IoT Manager website to view all successfully transmitted values as described in figure 7.
...
Figure 6 : Attached state description
...
Figure 7 : IoT Manager web site
Parameter | Value | Acceptable range |
---|---|---|
Cell ID | 8493413 | (228 − 1) i |
PCI | 212 | - |
EARFCN | 6374 | 0..65535 |
RSSI | -61 dBm | -113 dBm..-51dBm |
RSRP | -70 dBm | -140dBm..44dBm |
RSRQ | -10 dB | -3dB..-19.5 dB |
SNR | 21 dB | >= 25 dB |
ECL | 0 | 0..2 |
TX Time | 308 ms | |
RX Time | 59229 ms | |
RRC state | 0 | 0,1 |
Signal bars | 5 | 4..5 |
TX power | -11 dB | -40 dB..+23 dB |
TX Bytes | 235 bytes | |
RX Bytes | 238 bytes | |
TX Blocks | 11 | |
RX Blocks | 10 | |
RLC UL Rate | 1558 b/s | |
RLC DL Rate | 500 b/s | |
MAC UL Rate | 6800 b/s | |
MAC DL Rate | 5760 b/s |
Tab 1: Displayed network parameters
...
Once switched to the AT commands , the device cannot switch back to the EASY mode to do it , you need to unplug the device and restart the connection .
Switch between "AT" and "Easy" mode.
Message send by the device or the host.
Button to empty the list view (2 in figure 9)
The complete communication log history is recorded and can be saved in a text file.
List of AT commands
Select a single AT command to be sent to the device. The message string will be copied to message text field (8 in figure 9 ) .
Button to start sending of the AT command (8 in figure 9) to the device.
Message text field. The message to be sent to the device can be edited further.
...
Figure 9 : Control center
...
The tool uses live data from the NB-IoT network to calculate the expected battery lifetime, energy consumption and datarate.
Button to start the NB-IoT performance calculation.
The application sends real test data to the Cloud via NB-IoT to be able to record the needed time and energy consumption in the current NB-IoT cell.Button to get more information about the performance calculation and its assumptions in more detail. Performance Tab
...
Figure 13 : NB-IoT performance
Abbreviations
Abbreviation | Description |
---|---|
NB-IoT | Mobile communication standard "Narrowband Internet-of-Things" |
NB | Short version of "NB-IoT" |
RAT | Radio Access Technology |
PCI | Physical Cell Identidy |
EARFCN | E-UTRA Absolute Radio Frequency Channel Number |
RSSI | Received Signal Strength Indicator |
RSRP | Reference Signal Receive Power |
RSRQ | Reference Signal Received Quality |
SNR | Signal to noise ratio |
ECL | Enhancement coverage level |
RRC state | Radio Ressource Control |
RLC UL Rate | Radio Link Control Uplink Rate |
RLC DL Rate | Radio Link Control Downlink Rate |
MAC UL Rate | Medium Access Control Uplink Rate |
MAC DL Rate | Medium Access Control Downlink Rate |
Tab 2 : Abbreviations