saia-burgess PCD 7 Series User manual

Document-No. 26/793; Edition E2; 30.04.2005
Manual Modem PCD xx7 Serie

Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Content
1
0
Saia-Burgess Controls Ltd.
0.1 Dokument-History ........................................................................................... 3
0.2 Trademarks ..................................................................................................... 3
1 Introduction
1.1 Structure ......................................................................................................... 1-1
1.2 Restrictions ..................................................................................................... 1-2
2 Modem parameters and Main Driver functions
2.1 Configuration of the modem parameters ........................................................ 2-1
2.1.1 Structure field “COM_parameter” ................................................................. 2-1
2.1.2 Structure field “AT_COMMAND” ................................................................... 2-2
2.1.3 Structure field “MODEM_MESSAGE” ........................................................... 2-3
2.2 Main Driver function ........................................................................................ 2-5
2.2.1 Parameters ................................................................................................... 2-5
2.2.2 Function ........................................................................................................ 2-6
3 Receive and make a call
3.1 Receiving a call “Incoming call” ...................................................................... 3-1
3.1.1 Enabling the receiving ................................................................................... 3-1
3.1.2 Receiving process ......................................................................................... 3-1
3.2 Make an “Outgoing call” .................................................................................. 3-1
3.2.1 Starting call process ...................................................................................... 3-1
3.2.2 Function ........................................................................................................ 3-2
4 Protocols
4.1 Configuration DB ............................................................................................. 4-1
4.2 Enabling protocol ............................................................................................ 4-3
4.2.1 Function ........................................................................................................ 4-3
5 Example: Starting an application
5.1 Configuring the modem parameters ............................................................... 5-1
5.1.1 Parameter of the serial communication ........................................................ 5-1
5.1.2 AT command for the modem ......................................................................... 5-2
5.1.3 Answer message from the modem ............................................................... 5-2
5.1.4 Initialize DB ................................................................................................... 5-3
5.2 Initialization of the Driver ............................................................................... 5-3
5.3. Calling ............................................................................................................. 5-4
5.4 Switching the protocol ..................................................................................... 5-5
5.4.1 Configuration ................................................................................................. 5-5
5.4.2 Protocol enabling .......................................................................................... 5-6
6 Sending SMS
6.1 Structure ......................................................................................................... 6-1
6.2 Parameterization of the SMS system .............................................................. 6-1
6.2.1 Parameter in the “DB_Modem” ..................................................................... 6-1
6.2.2 SMS system parameters “DB_SMS” ............................................................ 6-2
6.3 SMS function ................................................................................................... 6-3

Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Content
2
0
Saia-Burgess Controls Ltd.
6.3.1 Integration to the application ......................................................................... 6-4
7 Sending Pager Messages
7.1 Structure ......................................................................................................... 7-1
7.2 Parameterization of the Pager system ............................................................ 7-1
7.2.1 Parameter in the “DB_Modem” ..................................................................... 7-2
7.2.2 Pager system parameters “Pager_DB” ......................................................... 7-2
7.2.3 Pager ........................................................................................................... 7-3
7.3 Pager function ................................................................................................. 7-3
7.3.1 Integration to the application ......................................................................... 7-4
8 Sending SMS-TAP
8.1 Structure ......................................................................................................... 8-1
8.2 Parameterization of the TAP system ............................................................... 8-1
8.2.1 Parameter in the “DB_Modem” ..................................................................... 8-2
8.2.2 TAP SMS system parameters “DB_TAP” ...................................................... 8-2
8.3 TAP function .................................................................................................... 8-3
8.3.1 Integration to the application ......................................................................... 8-4
9 Appendix
9.1 Appendix 1, Initialization strings ...................................................................... 9-1
9.2 Appendix 2, Error Codes ................................................................................. 9-2
9.2.1 Error returned by the Modem Driver function ................................................ 9-2
9.2.2 Error return by the calling function ................................................................ 9-3
9.2.3 Error return by the SMS function ................................................................. 9-3
9.2.4 Error return by the PAGER function ............................................................. 9-3
9.2.5 Error return by the TAP SMS function .......................................................... 9-4
9.3 Appendix 3, Pager character set ..................................................................... 9-4
9.4 Appendix 4, General ....................................................................................... 9-5
9.4.1 Icons ............................................................................................................. 9-5
9.4.2 Product and documentation concept ............................................................ 9-5
9.4.3 Technical support .......................................................................................... 9-6
9.4.4 Workshops, training literature ....................................................................... 9-6
9.4.5 Reliability and safety of electronic controllers ............................................... 9-7
9.4.6 About ourselves ............................................................................................ 9-8
Addresses of SAIA-Burgess companies ......................................................... 9-9

Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Content
3
0
Saia-Burgess Controls Ltd.
0.1 Dokument-History
Document-No. Edition Modification Publication Remarks
26/793 E1 30.06.2003 Published Edition
26/793 E2 30.04.2005 New Chapter 8 SMS TAP function
0.2 Trademarks
SAIA® and SAIA®PCD are registered trademarks of SAIA-Burgess Electronics AG
STEP ,SIMATIC, S7-300, S7-400, and Siemens are registered trademarks of
Siemens AG
Technical modifications and changes depending on state of the art.
SAIA-Burgess Controls Ltd, 2002. © All rights reserved.
Printed in Switzerland

Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Structure
Introduction
1-1
1
Saia-Burgess Controls Ltd.
1 Introduction
The modem library for the PCD xx7 serie allows a quick integration of telecommuni-
cation through phone line inside your S7-project. It has been made flexible to be able
of supporting most of the analog modem found on the market.
At the moment the library supports the following communication types:
● Between PCDs with the protocol (ASCII,RK512,DK3964 ) as Master or Slave.
● Between PCD and Supervisor with the protocol (ASCII,RK512,DK3964 ) as
Master or Slave.
● Between PCD and PG with the MPI protocol as Master or Slave.
● Between PCD and SMS Center with the protocol UCP (send SMS)
The flexibility of the library function gives the possibility to add new communication
types without investing too much in development.
1.1 Structure
The modem driver is based on one main function block (FB-Modem DRIVER) which
handles the command “sent to the modem” and “the answer received from the mo-
dem”. It controls the modem status and allows the other telecommunication function
to proceed. This function has to be called cyclically.
The modem DRIVER is referring to a Data Block (DB_Modem), which contains all the
internal parameters of the driver, status and also all the configurable parameters to
adapt the driver to your application and modem.
The calling function give the possibility to the system to call and connect with other
subscriber. This function doesn’t have direct access to the modem, in fact all the
request are transmitted to the DRIVER through the DB_Modem and the DRIVER is
then executing them.
When the connection with the other subscriber is established, then the serial COM
can be use directly by other function or process. The modem DRIVER stay in back
ground task to survey they status of the connection.
The actual function which are also implemented in the library are:
● Switching protocol to communicate with subscriber
● Sending SMS
● Sending Pager messages

Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Restrictions
Introduction
1-2
1
Saia-Burgess Controls Ltd.
All these functions will be seen in details later in this document and examples of us-
ing them will be shown.
1.2 Restrictions
There are few restrictions when using the modem library. Those are the following
restrictions:
 To handle correctly the modem and the telecommunication, the functions need
the modem control signals, as the DCD and DTR. Those have to be wired. Due
to this, only the serial interface 1 of the PCD (PCD2.F120) or interface 2 e.g. 4
(PCD7.F522 as one RS232) can be use for the modem communication.
 The number of all the function and data block in the modem library can be
changed, except the FC700 (which contains sub-functions for other functions).
 Using old or low cost modem, some restriction can apply.
 If using all possibilities of the modem library, 10 Kbytes of memory are neces
sary to integrate the whole library in your project.
Modem DRIVER
FB70
DB_Modem
DB100
MODEM
Calling function
FC701
SMS or Pager
function
Protocols function
SERIAL
COM 1
User
communication
function
S7 user
application
DCD
Modem DRIVER
sub-function
FC700
DTR

Saia-Burgess Controls Ltd.
Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Modem parameters and Main Driver functions
2
2-1
Confi guration of the modem parameters
2 Modem parameters and Main Driver functions
2.1 Configuration of the modem parameters
Most of the parameterization is done in one Data Block.
This Data Block is called “DB_Modem“ and its number in the library is the DB100.
The number of the DB can be changed as desired to fit in your project.
Depending on the different modem type in use a different DB has to be copied to
DB100, when this is used as DB_Modem
DB102 MODEM_T850 for using the ISDN modem
PCD2.T850
DB103 MODEM_T813 for using the analog modem
PCD2.T813
DB104 MODEM_T813Z42 for using the analog modem
PCD2.T813 or PCD2.T813z42
This “DB_Modem” is divided in two parts.
1. The first part is reserved for internal use of the Modem Driver, the field in the
DB is called „reserve“ and it’s the UDT100. Do not edit and change the
values of this field.
2. The second part is composed of 3 structures, which are:
 parameterization of the serial com “COM_parameter”
 AT command of the modem for the main function “AT_COMMAND”
 Specific modem answers “MODEM_MESSAGE”
Those structure are described in details in the following chapter.
 The “DB_Modem“ has to be edited on your S7-editor. After the values have
been modified make sure to initialize the value before using it.
 The value of the DB can be changed only by the S7-editor and not by your S7
software during run time.
2.1.1 Structure field “COM_parameter”
In this structure of the “DB_Modem“ you define the serial communication para-
meters, such as the baud rate, number of data bits, parity mode, etc…

Saia-Burgess Controls Ltd.
Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Modem parameters and Main Driver functions
2
2-2
Confi guration of the modem parameters
Description of parameters and their possible values (In Bold, default values):
Parameter Possible value Description
BAUD_RATE 300, 600, 1200,
2400, 4800, 9600,
19200, 38400
Frequency of the communication between the
PCD and the Modem. (In front and behind the
connection between the modems).
DATA_BIT 7 or 8Number of bit per character.
STOP_BIT 1 or 2 Number of stop bit at the character end.
PARITY_MODE 0 none
1 Even
2 Odd
3 Force Low
4 force High
Parity off the character
INTERFACE_TYPE 0 (RS232) Only RS232 is possible
ZVZ 1..2000, 20 Time out in ms.
Maximum time between character
IN_BUFFER_SIZE 1..4000, 500 Size in byte of the receiving buffer. The input
buffer is use by the modem DRIVER but also by
the other function which will access to the serial
port, like the protocol functions. Make sure it’s
large enough for the amount of data you will
need to exchange. This size can be set only
here.
OUT_BUFFER_SIZE 1..4000, 500 Size in byte of the send buffer. The output buffer
is use by the modem DRIVER but also by the
other function which will access to the serial port,
like the protocol functions. Make sure it’s large
enough for the amount of data you will need to
exchange. This size can be set only here.
2.1.2 Structure field “AT_COMMAND”
The structure “AT_COMMAND”, contains all the command sent to the modem. Like
the DIAL command or the initialization of the modem.
Those command are different from one modem to an other one. So they are specific
to the modem you are using. Refer to the operating manual of the modem to find the
right configuration. A list of modem and their command already tested on the SAIA
PCD xx7 is annexed (Annex 1).

Saia-Burgess Controls Ltd.
Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Modem parameters and Main Driver functions
2
2-3
Confi guration of the modem parameters
Description of the parameters and their syntax:
Parameter Description
RESET_COMMAND This is the AT command, which reset the modem.
The string has to start with AT and be finish with $R .
INIT_COMMAND_1 This string is the initialization command, to configure the mode of
the modem. The string has to start with AT and be finish with $R. In
this command make sure to disable to ECHO, usually the option is
“E0“.
INIT_COMMAND_2 This is the second initialization string, in case the first was too long.
The string has to start with AT and be finish with $R even if no
initialization command are required.
HANG_UP_COM-
MAND This is the command to disconnect from the phone line. The string has to start with AT and be finish with $R .
MODE_COMMAND String to switch from transparent mode to modem command mode.
DIAL_PREFIX This is the dialing prefix, depending if you are using a pulse or tone
dialling. The string has to start with AT .
DIAL_NUMBER_x Those 3 parameters are the 3 phones number, which the PCD can
call to. The string has to be ended with $R. The Dial_number will be
added to the Dial_prefix, do not duplicate the option.
DIAL_TEMP This area is not used, leave it free.
2.1.3 Structure field “MODEM_MESSAGE”
When the modem has executed a command or some call is incoming, the modem
will signal to the PCD the result of the operation with messages. Those messages
could be different between different kind of modem, so they have to be configure
corresponding to the modem used in the project. Also, the choice made in the initiali-
zation command has to be considered, if you choose the numeric or the message
answer.

Saia-Burgess Controls Ltd.
Manual Modem PCDxx7 Serie│Doc. 26/793; Ed. E2│30.04.2005
Modem parameters and Main Driver functions
2
2-4
Confi guration of the modem parameters
Numeric answer:
Usually the option for initialization is”V0“.(refer to your modem manual)
The identification of the answer in the structure need the following syntax, the number
of the answer, followed by the “$R“.
e.g. For the ERROR answer, the numeric value is 4, so the field ERROR of the struc-
ture “Modem_message“ will contains “4$R“.
Message answer:
Usually the option for initialization is “V1“.(refer to your modem manual)
The identification of the answer in the structure need the following syntax. A maxi-
mum of 7 characters and minimum of 4 characters of the answer message have to be
put in the field. The “$R“ shouldn’t be in. The character case is very important, usually
in upper case, be sure to write it correctly.
e.g. For the ERROR answer, the field ERROR of the structure “Modem_message“
will contain “ERROR“.
Description of the parameters and their most common values:
Parameters Common value Description
intern_7x - Those field are reserve for internal use.
!! Do not change the value !!
OK_STRING “OK“ Command executed by the modem successfully
OK_NUM 0$R Same as ”OK“, but the numeric value (needed after
reset)
CONNECT “CONNECT“ Message returned when the two modem have syn-
chronized and the connection is made.
RING “RING“ Incoming call
NO_CARRIER “NO CARRIER“ No modem has answered at the receiving side
ERROR “ERROR“ An error has been made during the last command
ERROR_NUM 4$R Same as “ERROR“, but the numeric value
NO_DIAL_TONE “NO DIAL TONE“ No dial tone has been detected
BUSY “BUSY“ The receiving side is busy
NO_ANSWER “NO ANSWER“ The receiving side is not answering
BLACK_LISTED “BLACK LISTED“ This number can’t be dialled anymore, it has failed too
many times