Billing Online Modem

Billing Online Setup when loaded on PNPSCADA as 'BillingOnline Modem'
remember to change the IP to your server's IP

000000#TCPIP=196.22.139.148#TCPPORT=56267#TCPMODE=1#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2#PINGMAX=5#APNN=INTERNET

Billing Online Setup in when loaded on PNPSCADA as 'Generic Active Modem'
remember to change the port number to the one allocated by the server

000000#TCPIP=196.22.139.148#TCPPORT=13001#TCPMODE=0#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2#PINGMAX=5#APNN=INTERNET

Old Billing Online Modem setup (before 2015)

000000#TCPIP=196.22.139.148#TCPPORT=56267#TCPMODE=1#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2#PINGMAX=5#APN=INTERNET

Get Modem Setup

000000#TCPIP?#TCPPORT?#TCPMODE?#TCPTYPE?#TCPIDLE?#PINGIP?#PINGTIME?#PINGMAX?#APNN?

Reset Billing Online Modem

000000#reset

Reset Billing Online Modem New (2017)

000000#resetnow


BLUE: RS485
GREEN: RS232
YELLOW: GSM Light. Flashes when connected to network. Solid on when not connected.
MAGENTA: Shines blue when connected to PNPSCADA.
RED: SIM Chip Vodacom.

The SIM number is written on the SIM chip. It is a 19-23 digit number and is written over 2 lines.
You can read it with a magnifying glass.
You need this number to give to Vodacom for them to activate the number on their network.

BOL Modem Commands

1. Sms commands for setup.

Send the following command as one SMS to the modem.
Only change the (SERVER IP TO CONNECT TO) and the (PORT NUMBER)

000000#TCPIP=SERVER IP TO CONNECT TO
#TCPPORT=PORT NUMBER
#TCPMODE=1
#TCPTYPE=C
#TCPIDLE=2
#PINGIP=GOOGLE.CO.ZA
#PINGTIME=2
#PINGMAX=5
#APN=INTERNET

The Modem can be added toe PnP as a Kocos modem. The port number must then be set to 56267
PLEASE NOTE that the above should all be on one line (with NO embedded spaces), e.g.
000000#TCPIP=192.22.139.148#TCPPORT=56267#TCPTYPE=C#TCPIDLE=2#PINGIP=GOOGLE.CO.ZA#PINGTIME=2#PINGMAX=5#APN=INTERNET#TCPMODE=1

(if the above example is shown on more than one line or with spaces, take it out before you SMS it, since it is an artefact of either the browser or the editor)

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 nameType of ValueExample Value
apn nameThe access point nameinternet


2.1.3 Examples:

You SendYour replyDescription
AT+APN='internet'OKIt was correct format and was accepted
AT+APN=internetERRORIt was in an incorrect format and was rejected


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 nameType of ValueExample Value
apn nameThe access point nameinternet
usernameThe Username of the apnname
passwordThe password of the apnpass


2.2.3 Examples:

You SendYour replyDescription
AT+PAPN='internet','name','pass'OKIt was correct format and was accepted
AT+PAPN=internet,name,passERRORIt was in an incorrect format and was rejected



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 nameType of ValueExample Value
Type ConnectionThe type of TCP connection to make
C = Client
S= Server
C
Server IPThe IP address of the server to connect to and DNS name if DNS server available192.154.156.234 or my.server.com
Server PortThe port on the server to connect to between 1 and 640001234
Max idle timeThe max time for no data before connection will be closed and reopened (in minutes)2 minutes


2.3.3 Examples:

You SendYour replyDescription
AT+TCP='C','MY.SERVER.COM',2OKModem set in client mode and has timeout of 2 minutes



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 nameType of ValueExample Value
modeSet the mode of authentication
0 = normal
1 = send sim Serial Nr
0


2.4.3 Examples:

You SendYour replyDescription
AT+TCPM=0OKSet modem not to authenticate on TCP connections
AT+TCPM=1OKSet modem to authenticate on TCP connection



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 nameType of ValueExample Value
PING ServerThe server address to pingwww.google.com
intervalTime between pings in minutes2
max failMax consecutive failed pings before modem will reset5


2.5.3 Examples:

You SendYour replyDescription
AT+PING='www.google.com',2,5OKModem will ping google every 2 minutes and if it does not get a good reply within 5 retries then it will reset



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 nameType of ValueExample Value
Sim pinThe pin to be used for the sim card0000


2.6.3 Examples:

You SendYour replyDescription
AT+SIM=1111OKThe modem will use this pin to unlock the sim card



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 nameType of ValueExample Value
none


2.7.3 Examples:

You SendYour replyDescription
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




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 nameType of ValueExample Value
none


2.9.3 Examples:

You SendYour replyDescription
AT+VER+VER: BOL_Power_Modem_1.12.03.20130420190805

OK
The current version of the application on the modem



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 nameType of ValueExample Value
Old pinSpecify the old pin1234
New PinSpecify the new pin1111


2.12.3 Examples:

You SendYour replyDescription
AT+PIN=1234,1111OKThe pin has been changed and saved


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 nameType of ValueExample Value
New PinSpecify the new sms pin000000


2.13.3 Examples:

You SendYour replyDescription
AT+LOCK=123456OKThe pin has been changed and saved for incoming SMS's



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.1Description

Read or Set the apn you need to connect to

3.1.2Example

You SMSSMS ReceivedDescription
000000#APN=internet#OKSet the APN to internet
000000#APN?#Apn:internetRead the current setting


3.2 Set The APN Username (APNUN)

3.2.1Description

Read or Set the apn username you need to connect to

3.2.2Example

You SMSSMS ReceivedDescription
000000#APNUN=bob#OKSet the APNUN to bob
000000#APNUN?#apn username:bobRead the current setting



3.3 Set the APN password (APNPW)

3.3.1Description

Read or Set the apn password you need to connect to

3.3.2Example

You SMSSMS ReceivedDescription
000000#APNPW=pass#OKSet the APNPW to pass
000000#APNPW?#apn passwordRead the current setting



3.4 Get the current IP address of the modem (MYIP)

3.4.1Description

Read the current IP address assigned by the network

3.4.2Example

You SMSSMS ReceivedDescription
000000#MYIP?#myIP:123.123.123.123Read the current setting



3.5 Set the Name of the Server to connect to (TCPIP)

3.5.1Description

Read or Set the IP address of the server to connect to

3.5.2Example

You SMSSMS ReceivedDescription
000000#TCPIP=my.server.com#OKSet the TCP Server to my.server.com
000000#TCPIP?#tcpip:my.server.comRead the current setting



3.6 Set the type of TCP connection(TCPTYPE)

3.6.1Description

Read or Set the TCP connection type
C for Client and S for Server

3.6.2Example

You SMSSMS ReceivedDescription
000000#TCPTYPE=C#OKSet the TCP type to Client
000000#TCPTYPE=S#OKSet the TCP type to Server
000000#TCPTYPE?#tcptype:CRead the current setting



3.7 Set the port of the server for the TCP socket (TCPPORT)

3.7.1Description

Read or Set the port for the TCP server

3.7.2Example

You SMSSMS ReceivedDescription
000000#TCPPORT=1234#OKSet the TCP port to 1234
000000#TCPPORT?#tcpport:1234Read the current setting



3.8 Set the idle timeout for the TCP socket (TCPIDLE)

3.8.1Description

Read or Set the max idle timeout before connection is reset

3.8.2Example

You SMSSMS ReceivedDescription
000000#TCPIDLE=2#OKSet the TCP Max idle to 2 minutes
000000#TCPIDLE?#tcpidle:2Read the current setting



3.9 Set the authentication mode (TCPMODE)

3.9.1Description

Read or Set the TCP authentication modes

3.9.2Example

You SMSSMS ReceivedDescription
000000#TCPMODE=0#OKSet the TCP Mode to no authentication
000000#TCPMODE=1#OKSet the TCP Mode to authentication on server
000000#TCPMODE?#tcpmode:0Read the current setting



3.10 Set the ping server address (PINGIP)

3.10.1Description

Read or Set the server that needs to be pinged

3.10.2Example

You SMSSMS ReceivedDescription
000000#PINGIP=www.google.com#OKSet the Ping Server to www.google.com
000000#PINGIP?#pingip:www.google.comRead the current setting



3.11 Set the ping intervals (PINGTIME)

3.11.1Description

Read or Set the delay time in minutes between pings

3.11.2Example

You SMSSMS ReceivedDescription
000000#PINGTIME=2#OKSet the ping interval to every 2 minutes
000000#PINGTIME?#ping int:2Read the current setting



3.12 Set the MAX ping failures (PINGMAX)

3.12.1Description

Read or Set the max pings that can fail before modem is reset

3.12.2Example

You SMSSMS ReceivedDescription
000000#PINGMAX=5#OKSet the max ping packets that can fail to 5
000000#PINGMAX?#ping failed:5Read the current setting



3.13 Specify the old Pin (PINOLD)

3.13.1Description

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.2Example

You SMSSMS ReceivedDescription
000000#PINOLD=0000#OKSet the current pin to 0000



3.14 Specify the new Pin (PINNEW)

3.14.1Description

Change the current pin to a new one

3.14.2Example

You SMSSMS ReceivedDescription
000000#PINNEW=1234#OKSet the new pin to 1234



3.15 execute the pin change (PINSET)

3.15.1Description

Same as PINNEW

3.15.2Example

You SMSSMS ReceivedDescription
000000#PINSET=1234#OKSet the new pin to 1234



3.16 change the SMS pin number (LOCK)

3.16.1Description

Set a new sms pin code

3.16.2Example

You SMSSMS ReceivedDescription
000000#LOCK=123456#SMS PIN SAVEDSet the SMS pin to 123456



3.17 Reset the modem now (RESET)

3.17.1Description

Reset the modem

3.17.2Example

You SMSSMS ReceivedDescription
000000#RESET#No replyReset the modem now




3.22 Get current app version (VER)

3.22.1Description

Read the current application commands

3.22.2Example

You SMSSMS ReceivedDescription
000000#VER#Ver: 1.12.1Read the current setting



3.23 List all available commands (LIST)

3.23.1Description

Read all the possible commands

3.23.2Example

You SMSSMS ReceivedDescription
000000#LIST#APN APNUN APNPW MYIP TCPIP TCPTYPE TCPPORT TCPIDLE PINGIP PINGTIME PINGMAX VER LOCK RESETRead all available commands


STANDALON MODEM
RJ45 - RJ12
1 - 6
4 - 5
5 - 3 (kyk maar net watter een van die 2 is geconnect)
6 - 2
4. Get the SIM card number
000000#AT+CCID