SIM7000E NB-IoT HAT User Manual share awesome hardware

SIM7000E NB-IOT HAT

Overview

This Raspberry Pi HAT features multi communication functionalities: NB-IoT, eMTC, EDGE, GPRS, and
GNSS.

The NB-IoT (NarrowBand-Internet of Things) and eMTC (enhanced Machine Type Communication) are
rising IoT communication technologies evolved from LTE (4G), with advantages include low power,
low cost, wide coverage, etc. They are suited for applications such as intelligent instruments, remote
controlling, asset tracking, remote monitoring, E-health, mobile POS terminals, sharing bikes, and so
on. While the GSM/GPRS, and EDGE are traditional 2G/2.5G technologies capable of sending SMS or
making other wireless communications.

Therefore, the SIM7000E NB-IoT HAT would be an ideal choice for either evaluating new rising
technologies, or simply communicating/positioning via multiple ways.

Features

⚫ Raspberry Pi connectivity, compatible with Raspberry Pi Zero/Zero W/Zero WH/2B/3B/3B+

⚫ Supports TCP, UDP, PPP, HTTP, FTP, MQTT, SMS, Mail, etc.
⚫ Supports GNSS positioning (GPS,GLONASS,BeiDou and Galileo)
⚫ Onboard USB interface, to test AT Commands, get GPS positioning data, and so on
⚫ Breakout UART control pins, to connect with host boards like Arduino/STM32
⚫ Onboard voltage translator, 3.3V by default, allows to be switched to 5V via 0Ω resistor
⚫ SIM card slot, compatible with both normal SIM card and NB-IoT specific card
⚫ 2x LED indicators, easy to monitor the working status
⚫ Baudrate: 300bps~3686400bps
⚫ Control via AT commands (3GPP TS 27.007, 27.005, and SIMCOM enhanced AT Commands)
⚫ Supports SIM application toolkit: SAT Class 3, GSM 11.14 Release 98, USAT
⚫ Comes with development resources and manual (examples for Raspberry /Arduino/STM32)

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

Contents

Overview................................................................................................................................................... 1

Features .................................................................................................................................................... 1

1. Hardware configuration ................................................................................................................... 4

1.1. Hardware configuration ...................................................................................................... 4

2. GPRS Debugging ............................................................................................................................... 6

2.1. General AT commands ........................................................................................................ 6

2.2. Local virtual severs settings ................................................................................................. 7

2.3. Searching WAN IP ................................................................................................................ 7

2.4. GPRS Setting ........................................................................................................................ 8

2.5. Sending data ........................................................................................................................ 8

2.6. Receiving data...................................................................................................................... 9

2.7. Deactivating Connection ..................................................................................................... 9

3. NB-IoT Debugging ............................................................................................................................ 9

3.1. General AT commands ........................................................................................................ 9

3.2. Local virtual severs settings .................................................................. 错误!未定义书签。

3.3. Searching WAN IP ................................................................................. 错误!未定义书签。

3.4. NB-IoT Setting .................................................................................................................... 10

3.5. Sending data ...................................................................................................................... 11

3.6. Receiving data.................................................................................................................... 11

3.7. Deactivating Connection ................................................................................................... 11

4. GNSS Debugging ............................................................................................................................. 12

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

4.1. General AT commands ...................................................................................................... 12

4.2. GPS Debugging................................................................................................................... 12

5. Using with Raspberry Pi ................................................................................................................. 14

5.1. Interface overview ............................................................................................................. 14

5.2. UART configuration of Raspberry Pi .................................................................................. 14

5.3. Minicom for UART debugging on Raspberry Pi ................................................................. 15

5.4. Examples ............................................................................................................................ 16

5.4.1. AT_Test ................................................................................................................. 16

5.4.2. GPS_Positioning .................................................................................................... 17

5.4.3. NB-IoT (TCP_IP) ..................................................................................................... 18

5.4.4. For more demo code,please visit the website wiki. .............................................. 18

1. Hardware configuration

1.1. Hardware configuration

This module comes with GSM antenna, GPS antenna and micro USB cable. Besides these you should
prepare a sim card or a nb-iot card:

1) Insert the SIM card to the card slot and connect the GSM antenna.
2) Connect the USB interface of SIM7000E NB-IoT HAT to PC with a micro USB cable. Then the PWR
indicator will keep bright.
Figure : Hardware connnection

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

3) Generally, the NET indicator will fast flash firstly (1 time per second), which means that the
module has not logged in the Network. After logging in, the indicator become to flash slowly (1
time every three seconds). Up to the local GSM network, this process that logging in will last
several seconds to dozens of seconds.

If you take too much time to log in and failed, please check that whether the GSM antenna is
connected correctly, and whether the SIM card is usable and insert correctly.

4) Install SIM7000 driver (windows driver: www.waveshare.com/wiki/File:SIM7X00-Driver.7z)

Open Device Manager to get the corresponding COM port number of SIM7000. For example, the
AT Port is COM19 as below. Users need to choose the correct port according to the Manager.
Figure: Devices Manager

1.2. Solder joints

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

Pin \ Solder Soldered to A side Soldered to B side

VCCIO 5V 3.3V (Default)

DTR P26 NC (Default)

PWR P4 (Control power supply via pin) 3.3V (Default:Power on automatically)

2. GPRS Debugging

2.1. General AT commands

Commands Description Return

AT+CGATT? Check the state of GPRS attachment +CGATT:1

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

1 Attached

AT+CSTT? AT+CSTT? : Check available APN +CSTT:

AT+CSTT AT+CSTT =”cmnet”: Set APN to CMNET OK

AT+CIICR Bring up wireless connection with GPRS OK

AT+CIFSR Get local IP address OK

AT+CIPSTART="Mode", "IP_Addr", "Port"

Mode: connection type; CONNECT
AT+CIPSTART
IP_Add: Remote server IP address; OK
Port: Remote server port

AT+CIPSEND Send data OK

1A (HEX format) Tell module to send data SEND OK

AT+CIPCLOSE Close TCP or UDP connection CLOSE OK

AT+CIPSHUT Deactivate GPRS PDP Context SHUT OK

2.2. Local virtual severs settings

Virtual servers define the mapping between service ports of WAN and web servers of LAN.
All requests from Internet to service ports of WAN will be redirected to the computer (web
servers of LAN) specified by the server IP. (see your router’s guide manual)

1) Log in Management Console of your router with browser (read your router’s guide manual for
specific address)
2) Set Port：1822 (The Port can’t be conflict to other’s. Here we set 1822)
3) Set LAN IP address of your computer (you can run CMD on your computer, and execute
command ipconfig to enquiry the address of IPv4), 192.168.6.168 as examples

2.3. Searching WAN IP

You can search “IP” on browser to get your WAN IP address.

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

2.4. GPRS Setting

1) AT+CSQ //To enquiry the quality of signal. The first parameter of response is signal quality
(Max is 31). The signal stronger, the value bigger.
2) AT+CREG? //Check Network registration. If the second parameter of response is 1 or 5, it
means that Network has been registered successfully
3) AT+CGATT? // Check the state of GPRS attachment
4) AT+CSTT="CMNET" //Set the Network according to actual situation. Here we use CMNET
5) AT+CIICR //Bring up wireless connection with GPRS
6) AT+CIFSR //Get the local IP address
7) AT+CIPSTART="TCP","113.81.232.178",1822 //Established TCP/IP connection

2.5. Sending data

1) AT+CIPSEND=33 //Send fixed length data

2) AT+CIPSEND // Send changeable length data

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

3) After getting the response >, edit the contents of message (has been converted) without Enter at
the end. Then send 1A in HEX format as below
4) If the data sent successfully, the server will receive the data.

2.6. Receiving data

1) Choose the IP address of module on peers input box

2) Input the data which you want to send：SIM7000 Test Succefully
3) Click Send button, you can see that module receive the data with COM assistant software

2.7. Deactivating Connection

1) Send AT+CIPCLOSE or AT+CIPSHUT to deactivate connection.

3. NB-IoT Debugging

3.1. General AT commands

Commands Description Return

+CGATT:1
AT+CGATT? Check the state of GPRS attachment
1 Attached

+CPSI:
AT+CPSI? AT+CPSI?: Inquiring UE information
OK

+CGNAPN:
AT+CGNAPN Check available APN
OK

AT+CSTT AT+CSTT =”cmnet”: Set APN to CMNET OK

AT+CIICR Bring up wireless connection with GPRS OK

AT+CIFSR Get local IP address OK

AT+CIPSTART="Mode", "IP_Addr", "Port"

Mode: connection type; CONNECT
AT+CIPSTART
IP_Add: Remote server IP address; OK
Port: Remote server port

AT+CIPSEND Send data OK

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

1A (HEX format) Tell module to send data SEND OK

AT+CIPCLOSE Close TCP or UDP connection CLOSE OK

AT+CIPSHUT Deactivate GPRS PDP Context SHUT OK

3.2. NB-IoT Setting

1) AT+CSQ //To enquiry the quality of signal. The first parameter of response is signal quality
(Max is 31). The signal stronger, the value bigger.
2) AT+CREG? //Check Network registration. If the second parameter of response is 1 or 5, it
means that Network has been registered successfully
3) AT+CGATT? // Check the state of GPRS attachment
4) AT+CPSI? // Inquiring UE system information
5) AT+CGNAPN // Get network APN in CAT-M or NB-IOT
6) AT+CSTT="T" //Set the Network according to actual situation. Here we use T
7) AT+CIICR //Bring up wireless connection with GPRS
8) AT+CIFSR //Get the local IP address
9) AT+CIPSTART="TCP","118.190.93.84",2317 //Established TCP/IP connection

10

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

3.3. Sending data

5) AT+CIPSEND=33 //Send fixed length data

6) AT+CIPSEND // Send changeable length data
7) After getting the response >, edit the contents of message (has been converted) without Enter at
the end. Then send 1A in HEX format as below
8) If the data sent successfully, the server will receive the data.

3.4. Receiving data

4) Choose the IP address of module on peers input box

5) Input the data which you want to send：SIM7000 Test Succefully
6) Click Send button, you can see that module receive the data with COM assistant software

3.5. Deactivating Connection

Send AT+CIPCLOSE or AT+CIPSHUT to deactivate connection.

11

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

4. GNSS Debugging

4.1. General AT commands

Commands Description Return

GNSS Power Control:

AT+CGNSPWR AT+CGNSPWR =1:Turn on OK
AT+CGNSPWR =0:Turn off

AT+CGNSTST=1:Send data received to AT Port

AT+CGNSTST OK
AT+CGNSTST=0: Stop sending data received to AT Port

+CGNSINF:
AT+CGNSINF GNSS navigation information parsed from NMEA sentences
OK

4.2. GPS Debugging

1) Connecting the GPS antenna, and place the receiver on open area outdoor
2) AT+CGNSPWR=1 //Turn on power of GPS
3) AT+CGNSTST=1 // Start to sending data received to AT Port
Open u-center and set the Port and Baudrate(AT Port, COM25).
Of course, you can use another port(NMEA Port,COM27)

4) AT+CGNSTST=0 // Stop sending data received to UART

5) AT+CGNSINF // Print the GPS information

6) AT+CGNSPWR=0 //Turn off power of GPS

12

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

13

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

5. Using with Raspberry Pi

5.1. Interface overview

The default relationship between SIM7000 control pins and Raspberry Pi IOs is shown in Table 1.

Table 1: The relationship between SIM7000 control pins and Raspberry Pi IOs

SIM7000 IO of Raspberry Pi B+ Description

5V 5V Power supply (5V)
GND GND Ground
TXD P15 / RXD UART pin
RXD P14 / TXD UART pin
PWR P4 (Need to modify the back solder joint) Power up the module

5.2. UART configuration of Raspberry Pi

Because UART of Raspberry Pi is used for Linux console output by default, if we want to use the UART,
we need to change the settings. Executing this command to enter the configuration page ：

sudo raspi-config

14

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

Choose Interfacing Options -> Serial -> no->yes , to disable Linux’s use of console
UART Open /boot/config.txt file, find the below statement and uncomment it to enable the UART.
You can directly append it at the end of file as well.

enable_uart=1

Then reboot.

5.3. Minicom for UART debugging on Raspberry Pi

Inserting the module to Raspberry Pi and plug the jumper B,

Install minicom，minicom is a text-based modem control and terminal emulation program for Linux：

sudo apt-get install minicom

Execute command: minicom -D /dev/ttyS0 （ttyS0 is the UART of Raspberry Pi 3B）

Baud rate is 115200 by default. If you need to change the baud rate, for example 9600, you can add
the parameter -b 9600.

The user UART device of Raspberry Pi 2B/Zero is ttyAMA0, and ttyS0 of Raspberry Pi 3B

Testing Bluetooth function as examples:

15

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

5.4. Examples

Download the demo code from wiki and copy to the Raspberry Pi (for example, /home/pi/SIM7000X)

Enter the bcm2835 directory, compile and install the BCM2835 library:

chmod +x configure && ./configure && sudo make && sudo make install

5.4.1. AT_Test

cd example/AT_Test && sudo ./AT_Test

16

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

5.4.2. GPS_Positioning

cd example/GPS_Positioning && sudo ./GPS_Positioning

17

Rev1.0 June 8, 2018

SIM7000E NB-IoT HAT User Manual share awesome hardware

5.4.3. NB-IoT (TCP_IP)

cd example/NB-IoT && sudo ./TCP_IP

5.4.4. For more demo code,please visit the website wiki.

18

Rev1.0 June 8, 2018