sdg.matiaan
2019-05-02 13:21
Last Edited 2024-09-04 15:33
To Setup a BillingOnline modem as a Billing Online Modem send this SMS:
000000#TCPIP=196.22.139.148#TCPPORT=56267#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2
#PINGMAX=5#APN=INTERNET#TCPMODE=1
To Setup a BOL modem to connect to pnpscada (adam port 13000) as a Generic Active GPRS modem send, this SMS:
000000#TCPIP=196.22.139.148#TCPPORT=13000#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2
#PINGMAX=5#APN=INTERNET
To Setup a New Version BOL (2015) modem to connect to pnpscada (adam port 13000) as a Generic Active GPRS modem, send, this SMS:
000000#TCPIP=196.22.139.148#TCPPORT=13000#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2
#PINGMAX=5#APNN=INTERNET
To Setup a BOL modem via COM port, send the following AT command:
AT+TCP='C','196.22.139.148',13000,2;+PING='GOOGLE.CO.ZA',2,5;+APN='INTERNET'
Setup command returns multiple lines with 'OK' when it works.
If you get 'ERROR' at least one line failed.
If you send a setup with command 'APNN' to an old modem, you will get 'ERROR'. Please use APN.
If you send a setup with command 'APN' to a new modem, you will get 'ERROR'. Please use APNN.
To get the full setup:
000000#TCPIP?#TCPPORT? #TCPTYPE?#TCPIDLE?#PINGIP?#PINGTIME?#PINGMAX?#APNN?#TCPMODE?
sdg.marinusvz
2013-03-27 09:00
To see a modem's current settings, use something like 000000#TCPIP=?
Please note, if you set everything up correctly on your modem, and on your server, and you can still not connect, the problem could be that the port you've configured are not routed through to the server.
Let me explain: what sometimes happen, is that there is a router next to the server, with the static internet IP, which then does port forwarding on certain ports, to the server's LAN address, or some similar setup. In that case, you've probably only forwarded 80 and 443 and 22, and possibly one or two other ones. For this first firmware version of the BOL modem, each modem gets its own dedicated port to connect on, so you need to go to the router, and add each port associated with a modem on pnpscada to be port-forwarded as well, e.g. 13001, or whatever you set it as.
Under normal circumstances we open up the firewall for those ports, so it should not be the fire-wall on the server that's blocking it. Rather it should be some outside firewall, or some missing ports in the port forwarding setup.
sdg.marinusvz
2013-07-08 14:17
Parameter name | Type of Value | Example Value |
apn name | The access point name | internet |
You Send | Your reply | Description |
AT+APN="internet" | OK | It was correct format and was accepted |
AT+APN=internet | ERROR | It was in an incorrect format and was rejected |
Parameter name | Type of Value | Example Value |
apn name | The access point name | internet |
username | The Username of the apn | name |
password | The password of the apn | pass |
You Send | Your reply | Description |
AT+PAPN="internet","name","pass" | OK | It was correct format and was accepted |
AT+PAPN=internet,name,pass | ERROR | It was in an incorrect format and was rejected |
Parameter name | Type of Value | Example Value |
Type Connection | The type of TCP connection to make C = Client S= Server | C |
Server IP | The IP address of the server to connect to and DNS name if DNS server available | 192.154.156.234 or my.server.com |
Server Port | The port on the server to connect to between 1 and 64000 | 1234 |
Max idle time | The max time for no data before connection will be closed and reopened (in minutes) | 2 minutes |
You Send | Your reply | Description |
AT+TCP="C","MY.SERVER.COM",2 | OK | Modem set in client mode and has timeout of 2 minutes |
Parameter name | Type of Value | Example Value |
mode | Set the mode of authentication 0 = normal 1 = send sim Serial Nr | 0 |
You Send | Your reply | Description |
AT+TCPM=0 | OK | Set modem not to authenticate on TCP connections |
AT+TCPM=1 | OK | Set modem to authenticate on TCP connection |
Parameter name | Type of Value | Example Value |
PING Server | The server address to ping | www.google.com |
interval | Time between pings in minutes | 2 |
max fail | Max consecutive failed pings before modem will reset | 5 |
You Send | Your reply | Description |
AT+PING="www.google.com",2,5 | OK | Modem will ping google every 2 minutes and if it does not get a good reply within 5 retries then it will reset |
Parameter name | Type of Value | Example Value |
Sim pin | The pin to be used for the sim card | 0000 |
You Send | Your reply | Description |
AT+SIM=1111 | OK | The modem will use this pin to unlock the sim card |
sdg.marinusvz
2013-07-08 14:18
Parameter name | Type of Value | Example Value |
none | | |
You Send | Your reply | Description |
AT+ALL | +ALL: [APN] Name:internet UserName: Password: [GPRS] IP Addr:10.154.152.2 [TCP] Type:C Serv IP:my.server.com Serv Port:1111 MAX idle:2 Mode:0 [PING] Serv IP: www.google.com Interval:2 Min Max Fail:5 OK | Display the current settings on the modem |
Parameter name | Type of Value | Example Value |
none | | |
You Send | Your reply | Description |
AT+VER | +VER: BOL_Power_Modem_1.12.03.20130420190805 OK | The current version of the application on the modem |
Parameter name | Type of Value | Example Value |
Old pin | Specify the old pin | 1234 |
New Pin | Specify the new pin | 1111 |
You Send | Your reply | Description |
AT+PIN=1234,1111 | OK | The pin has been changed and saved |
Parameter name | Type of Value | Example Value |
New Pin | Specify the new sms pin | 000000 |
You Send | Your reply | Description |
AT+LOCK=123456 | OK | The pin has been changed and saved for incoming SMS's |
You SMS | SMS Received | Description |
000000#APN=internet# | OK | Set the APN to internet |
000000#APN?# | Apn:internet | Read the current setting |
You SMS | SMS Received | Description |
000000#APNUN=bob# | OK | Set the APNUN to bob |
000000#APNUN?# | apn username:bob | Read the current setting |
You SMS | SMS Received | Description |
000000#APNPW=pass# | OK | Set the APNPW to pass |
000000#APNPW?# | apn password:pass | Read the current setting |
You SMS | SMS Received | Description |
000000#MYIP?# | myIP:123.123.123.123 | Read the current setting |
You SMS | SMS Received | Description |
000000#TCPIP=my.server.com# | OK | Set the TCP Server to my.server.com |
000000#TCPIP?# | tcpip:my.server.com | Read the current setting |
sdg.marinusvz
2013-07-08 14:18
You SMS | SMS Received | Description |
000000#TCPTYPE=C# | OK | Set the TCP type to Client |
000000#TCPTYPE=S# | OK | Set the TCP type to Server |
000000#TCPTYPE?# | tcptype:C | Read the current setting |
You SMS | SMS Received | Description |
000000#TCPPORT=1234# | OK | Set the TCP port to 1234 |
000000#TCPPORT?# | tcpport:1234 | Read the current setting |
You SMS | SMS Received | Description |
000000#TCPIDLE=2# | OK | Set the TCP Max idle to 2 minutes |
000000#TCPIDLE?# | tcpidle:2 | Read the current setting |
You SMS | SMS Received | Description |
000000#TCPMODE=0# | OK | Set the TCP Mode to no authentication |
000000#TCPMODE=1# | OK | Set the TCP Mode to authentication on server |
000000#TCPMODE?# | tcpmode:0 | Read the current setting |
You SMS | SMS Received | Description |
000000#PINGIP=www.google.com# | OK | Set the Ping Server to www.google.com |
000000#PINGIP?# | pingip:www.google.com | Read the current setting |
You SMS | SMS Received | Description |
000000#PINGTIME=2# | OK | Set the ping interval to every 2 minutes |
000000#PINGTIME?# | ping int:2 | Read the current setting |
You SMS | SMS Received | Description |
000000#PINGMAX=5# | OK | Set the max ping packets that can fail to 5 |
000000#PINGMAX?# | ping failed:5 | Read the current setting |
You SMS | SMS Received | Description |
000000#PINOLD=0000# | OK | Set the current pin to 0000 |
You SMS | SMS Received | Description |
000000#PINNEW=1234# | OK | Set the new pin to 1234 |
You SMS | SMS Received | Description |
000000#PINSET=1234# | OK | Set the new pin to 1234 |
You SMS | SMS Received | Description |
000000#LOCK=123456# | SMS PIN SAVED | Set the SMS pin to 123456 |
You SMS | SMS Received | Description |
000000#RESET# | No reply | Reset the modem now |
You SMS | SMS Received | Description |
000000#VER# | Ver: 1.12.1 | Read the current setting |
You SMS | SMS Received | Description |
000000#LIST# | APN APNUN APNPW MYIP TCPIP TCPTYPE TCPPORT TCPIDLE PINGIP PINGTIME PINGMAX VER LOCK RESET | Read all available commands |
sdg.matiaan
2015-03-04 14:35
From version 1.12.16 the SMS command for APN has changed to “000000#APNN=INTERNET”. The AT commands
via RS232 however stays the same.
To check the version of the current software you can SMS “000000#VER?”
BOL Modem Commands
2. Serial Port AT Commands
Important!: All string parameters you send as AT commands needs to me between Double
Quotes (")
If you want to send multiple At commands at the same time then only the first AT
commands has the AT in front and is separated by semicolon ( ; )
E.g.:
To send the following at commands
AT+APN="internet"
AT+TCP="C","Your.Server.com",1111,2
You can send it as one string like this:
AT+APN="internet";+TCP="C","Your.Server.com",1111,2
2.1 Set APN Settings (AT+APN)
2.1.1 Description:
This command only sets the access point name (apn) that the modem needs to connect to,
if you have to specify username and password then use the alterative command AT+PAPN
2.1.2 Parameters:
AT+APN=
Parameter name Type of Value Example Value
apn name The access point name internet
2.1.3 Examples:
You Send Your reply Description
AT+APN="internet" OK It was correct format and
AT+APN=internet ERROR It was in an incorrect format
2.2 Set APN Settings with username and password (AT+PAPN)
2.2.1 Description:
This command sets the access point name (apn); username and password that the modem
needs to connect to, if you only need to specify the APN name then use the alterative
command AT+APN
2.2.2 Parameters:
AT+PAPN=
Parameter name Type of Value Example Value
apn name The access point name internet
username The Username of the apn name
password The password of the apn pass
2.2.3 Examples:
You Send Your reply Description
AT+PAPN="internet","name","pass"
AT+PAPN=internet,name,pass
OK It was correct format and
ERROR It was in an incorrect format
2.3 Set TCP Server/Client Settings (AT+TCP)
2.3.1 Description:
This Command will set the TCP server that it needs to connect to. You can select Server
or Client Mode
In Server mode the modem will wait for the server to connect to the modem to start the
comms
And in Client mode the modem will connect to the server that needs to be in listening
mode for incoming connections
2.3.2 Parameters:
AT+TCP=
Parameter name Type of Value Example Value
Type Connection The type of TCP connection
Server IP The IP address of the server
Server Port The port on the server to
Max idle time The max time for no data
to make
C = Client
S= Server
to connect to and DNS
name if DNS server
available
connect to between 1 and
64000
before connection will be
closed and reopened (in minutes)
2.3.3 Examples:
You Send Your reply Description
AT+TCP="C","MY.SERVER.COM",2
OK Modem set in client mode
2.4 Set TCP mode of operation (AT+TCPM)(Always Connected)
2.4.1 Description:
You set the mode of operation of the TCP authentication to the server, if the modem does
not need to authenticate then you can set this to 0 and the TCP socket will just be
transparent connection and if the modem needs to authenticate with the SIM card serial
number on connection to server then you need to set this to 1
2.4.2 Parameters:
AT+TCPM=
Parameter name Type of Value Example Value
mode Set the mode of
authentication
0 = normal
1 = send sim Serial Nr
2.4.3 Examples:
You Send Your reply Description
AT+TCPM=0 OK Set modem not to
AT+TCPM=1 OK Set modem to authenticate
2.5 Set the Ping Server Settings (AT+PING)
2.5.1 Description:
Setup a server to ping at regular intervals to see if modem is still connected to internet.
If the modem fails to ping the server then it will reset and re-establish internet connection.
This is used to prevent where the networks drop the connection and do not notify the
modem
2.5.2 Parameters:
AT+PING=
Parameter name Type of Value Example Value
PING Server The server address to ping www.google.com
interval Time between pings in
max fail Max consecutive failed
minutes
pings before modem will
reset
2.5.3 Examples:
You Send Your reply Description
AT+PING="www.google.com",2,5
OK Modem will ping google
2.6 Set The Pin number for the sim cards (AT+SIM)
2.6.1 Description:
This command will set the sim pin code that the modem needs to use to unlock the sim
card before it can be used
2.6.2 Parameters:
AT+SIM=
Parameter name Type of Value Example Value
Sim pin The pin to be used for the
sim card
2.6.3 Examples:
You Send Your reply Description
AT+SIM=1111 OK The modem will use this pin
2.7 Read all the settings on the modem (AT+ALL)
2.7.1 Description:
This command is used to display all the current settings on the modem
2.7.2 Parameters:
AT+ALL
Parameter name Type of Value Example Value
none
2.7.3 Examples:
You Send Your reply Description
AT+ALL +ALL:
[APN]
Name:internet
UserName:
Password:
[GPRS]
IP Addr:10.154.152.2
[TCP]
Type:C
Serv IP:my.server.com
Serv Port:1111
MAX idle:2
Mode:0
[PING]
Serv IP: www.google.com
Interval:2 Min
Max Fail:5
OK
2.9 Get the version of the App (AT+VER)
2.9.1 Description:
Displays the Application Version loaded on the modem
2.9.2 Parameters:
AT+VER
Parameter name Type of Value Example Value
none
2.9.3 Examples:
You Send Your reply Description
AT+VER +VER:
BOL_Power_Modem_1.12.
03.20130420190805
OK
2.12 Change Pin on Active Sim card (AT+PIN)
2.12.1 Description:
Change the current pin of the sim card and save it to use later
2.12.2 Parameters:
AT+PIN=
Parameter name Type of Value Example Value
Old pin Specify the old pin 1234
New Pin Specify the new pin 1111
2.12.3 Examples:
You Send Your reply Description
AT+PIN=1234,1111 OK The pin has been changed
2.13 Change Pin for SMS commands (AT+LOCK)
2.13.1 Description:
Change pin code to validate incoming SMS's
If the pin code is not correct then the modem will reject the SMS commands
2.13.2 Parameters:
AT+LOCK=
Parameter name Type of Value Example Value
New Pin Specify the new sms pin 000000
2.13.3 Examples:
You Send Your reply Description
AT+LOCK=123456 OK The pin has been changed
sdg.matiaan
2015-03-04 14:36
3. SMS Commands
The SMS will always start with a password (default is 000000#)
Then you put the parameter that you want to read or set separated with hash (#) each sms
is limited to 160 characters (multipart sms's will not be handled)
E.g: multi command SMS
000000#APN=internet#TCPIP=my.server.com#TCPPORT=1234#
The following is allowed SMS commands
APN
APNUN
APNPW
MYIP
TCPIP
TCPTYPE
TCPPORT
TCPIDLE
TCPMODE
PINGIP
PINGTIME
PINGMAX
PINOLD
PINNEW
PINSET
LOCK
RESET
VER
LIST
3.1 Set the APN name (APN)
3.1.1 Description
Read or Set the apn you need to connect to
Please note that from version 1.12.16 the SMS command for APN has changed to
000000#APNN=Internet#
To check your version SMS “000000#VER?”
3.1.2 Example
You SMS SMS Received Description
000000#APN=internet# OK Set the APN to internet
000000#APN?# Apn:internet Read the current setting
3.2 Set The APN Username (APNUN)
3.2.1 Description
Read or Set the apn username you need to connect to
3.2.2 Example
You SMS SMS Received Description
000000#APNUN=bob# OK Set the APNUN to bob
000000#APNUN?# apn username:bob Read the current setting
3.3 Set the APN password (APNPW)
3.3.1 Description
Read or Set the apn password you need to connect to
3.3.2 Example
You SMS SMS Received Description
000000#APNPW=pass# OK Set the APNPW to pass
000000#APNPW?# apn password : pass Read the current setting
3.4 Get the current IP address of the modem (MYIP)
3.4.1 Description
Read the current IP address assigned by the network
3.4.2 Example
You SMS SMS Received Description
000000#MYIP?# myIP:123.123.123.123 Read the current setting
3.5 Set the Name of the Server to connect to (TCPIP)
3.5.1 Description
Read or Set the IP address of the server to connect to
3.5.2 Example
You SMS SMS Received Description
000000#TCPIP=my.server.com#
OK Set the TCP Server to
000000#TCPIP?# tcpip:my.server.com Read the current setting
3.6 Set the type of TCP connection(TCPTYPE)
3.6.1 Description
Read or Set the TCP connection type
C for Client and S for Server
3.6.2 Example
You SMS SMS Received Description
000000#TCPTYPE=C# OK Set the TCP type to Client
000000#TCPTYPE=S# OK Set the TCP type to Server
000000#TCPTYPE?# tcptype:C Read the current setting
3.7 Set the port of the server for the TCP socket (TCPPORT)
3.7.1 Description
Read or Set the port for the TCP server
3.7.2 Example
You SMS SMS Received Description
000000#TCPPORT=1234# OK Set the TCP port to 1234
000000#TCPPORT?# tcpport:1234 Read the current setting
3.8 Set the idle timeout for the TCP socket (TCPIDLE)
3.8.1 Description
Read or Set the max idle timeout before connection is reset
3.8.2 Example
You SMS SMS Received Description
000000#TCPIDLE=2# OK Set the TCP Max idle to 2
000000#TCPIDLE?# tcpidle:2 Read the current setting
3.9 Set the authentication mode (TCPMODE)
3.9.1 Description
Read or Set the TCP authentication modes
3.9.2 Example
You SMS SMS Received Description
000000#TCPMODE=0# OK Set the TCP Mode to no
000000#TCPMODE=1# OK Set the TCP Mode to
000000#TCPMODE?# tcpmode:0 Read the current setting
3.10 Set the ping server address (PINGIP)
3.10.1 Description
Read or Set the server that needs to be pinged
3.10.2 Example
You SMS SMS Received Description
000000#PINGIP=www.google.com#
000000#PINGIP?# pingip:www.google.com Read the current setting
OK Set the Ping Server to
3.11 Set the ping intervals (PINGTIME)
3.11.1 Description
Read or Set the delay time in minutes between pings
3.11.2 Example
You SMS SMS Received Description
000000#PINGTIME=2# OK Set the ping interval to
000000#PINGTIME?# ping int:2 Read the current setting
3.12 Set the MAX ping failures (PINGMAX)
3.12.1 Description
Read or Set the max pings that can fail before modem is reset
3.12.2 Example
You SMS SMS Received Description
000000#PINGMAX=5# OK Set the max ping packets
000000#PINGMAX?# ping failed:5 Read the current setting
3.13 Specify the old Pin (PINOLD)
3.13.1 Description
Set the current pin on the sim card (even if pin is disabled you need the correct sim pin to
change it to new one)
3.13.2 Example
You SMS SMS Received Description
000000#PINOLD=0000# OK Set the current pin to 0000
3.14 Specify the new Pin (PINNEW)
3.14.1 Description
Change the current pin to a new one
3.14.2 Example
You SMS SMS Received Description
000000#PINNEW=1234# OK Set the new pin to 1234
3.15 execute the pin change (PINSET)
3.15.1 Description
Same as PINNEW
3.15.2 Example
You SMS SMS Received Description
000000#PINSET=1234# OK Set the new pin to 1234
3.16 change the SMS pin number (LOCK)
3.16.1 Description
Set a new sms pin code
3.16.2 Example
You SMS SMS Received Description
000000#LOCK=123456# SMS PIN SAVED Set the SMS pin to 123456
3.17 Reset the modem now (RESET)
3.17.1 Description
Reset the modem
3.17.2 Example
You SMS SMS Received Description
000000#RESET# No reply Reset the modem now
3.22 Get current app version (VER)
3.22.1 Description
Read the current application commands
3.22.2 Example
You SMS SMS Received Description
000000#VER# Ver: 1.12.1 Read the current setting
3.23 List all available commands (LIST)
3.23.1 Description
Read all the possible commands
3.23.2 Example
You SMS SMS Received Description
000000#LIST# APN APNUN APNPW Read all available
MYIP TCPIP TCPTYPE
TCPPORT TCPIDLE
PINGIP PINGTIME
PINGMAX VER LOCK
RESET
4.1.1 Modem PIN-OUTS
PM1417, PM230 and PM100
RS485
1. NC
2. GND
3. A
4. B
5.NC
6. NC
RS232
1. TX
2. RX
3. TX
4. GND
5. NC
6. (V+ supply on PM1417)
10pin Header
1. NC
2. NC
3. TX
4. CTS
5. RX
6. RTS
7. NC
8. NC
9. GND
10. NC