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
sdg.matiaan
2025-01-24 13:12
Check for latest firmware by sending ?000000#VER?, it should be 3.0.7.0
Please contact support@billingonline.co.za to obtain the latest firmware.