Waveshare SIM7000E User manual

SIM7000E NB-IoT HAT User Manual
1
Rev1.0 June 8, 2018
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)

SIM7000E NB-IoT HAT User Manual
2
Rev1.0 June 8, 2018
share awesome hardware

SIM7000E NB-IoT HAT User Manual
3
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
4
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
5
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
6
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
7
Rev1.0 June 8, 2018
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
AT+CIPSTART="Mode", "IP_Addr", "Port"
Mode: connection type;
IP_Add: Remote server IP address;
Port: Remote server port
CONNECT
OK
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.

SIM7000E NB-IoT HAT User Manual
8
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
9
Rev1.0 June 8, 2018
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
AT+CGATT?
Check the state of GPRS attachment
+CGATT:1
1 Attached
AT+CPSI?
AT+CPSI?: Inquiring UE information
+CPSI:
OK
AT+CGNAPN
Check available APN
+CGNAPN:
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
AT+CIPSTART="Mode", "IP_Addr", "Port"
Mode: connection type;
IP_Add: Remote server IP address;
Port: Remote server port
CONNECT
OK
AT+CIPSEND
Send data
OK

SIM7000E NB-IoT HAT User Manual
10
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
11
Rev1.0 June 8, 2018
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.

SIM7000E NB-IoT HAT User Manual
12
Rev1.0 June 8, 2018
share awesome hardware
4. GNSS Debugging
4.1. General AT commands
Commands
Description
Return
AT+CGNSPWR
GNSS Power Control:
AT+CGNSPWR =1:Turn on
AT+CGNSPWR =0:Turn off
OK
AT+CGNSTST
AT+CGNSTST=1:Send data received to AT Port
AT+CGNSTST=0: Stop sending data received to AT Port
OK
AT+CGNSINF
GNSS navigation information parsed from NMEA sentences
+CGNSINF:
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

SIM7000E NB-IoT HAT User Manual
13
Rev1.0 June 8, 2018
share awesome hardware

SIM7000E NB-IoT HAT User Manual
14
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
15
Rev1.0 June 8, 2018
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:

SIM7000E NB-IoT HAT User Manual
16
Rev1.0 June 8, 2018
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

SIM7000E NB-IoT HAT User Manual
17
Rev1.0 June 8, 2018
share awesome hardware
5.4.2. GPS_Positioning
cd example/GPS_Positioning && sudo ./GPS_Positioning

SIM7000E NB-IoT HAT User Manual
18
Rev1.0 June 8, 2018
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.