Creating a RawSerial Carrier

Top  Previous  Next

This protocol tells PageGate to send a Raw formatted string of data through an RS232/serial line.

 

1)Right click Carriers.

CarriersContext

 

2)Select Add.

3)Select the RawSerial protocol.

RawSerial1

 

4)Enter a name in the Carrier field.

5)While it is unlikely that you may need to have a phone number passed as part of the RawSerial transmission, PageGate can still be configured to issue a phone number to the receiving serial device. Most implementations of this protocol will leave this field blank.

 

6)Set the Baud Rate, Parity, Data Bits and Stop Bits to match the requirements of the system or hardware that's going to be receiving this traffic.

7)If the receiving system requires a series of characters to be passed before it can accept input, enter that character or character string in to the Init String field.

8)Set the Max Chars field to the maximum number of characters you want output in a single transmission. The maximum value of this field is 6000.

Note: The Carrier Max Chars field determines the number of characters that can be received in a single message. If the recipient Max Chars value is set higher than the carrier Max Chars value, PageGate will break up long messages based on the character limitation in the carrier. For example, if you have the carrier configured for 160 Max Chars and you set the recipient Max Chars value to 3000, then send a 400 character message to this recipient, PageGate will break up the 400 character count message in to two 160 character messages and one 80 character message. When the device receives the message, it will be prefixed with part 1/3, 2/3, 3/3 to indicate the multi-part nature of the message delivered.

 

RawSerial2

 

9)Click Apply.

 

If the receiving system has special formatting requirements, you can configure that in the Template sub-section of a carrier.

Template

 

In the Text section of the template, you can configure a string of plain text and Macros to tell PageGate what should be output and in what order. For example, if we used the following:
 
%Recipient%

%Sender%

%Message%

 

That tells PageGate to output the recipient's name followed by a carriage return, line feed then the recorded sender value followed by a carriage return, line feed then the body of the message in the file written.

 

As another example, if we used the following:

USER: %RecipientId%
DATA: %Message%

 

That tells PageGate to output the text USER: before inserting the recipient's ID/PIN value followed by a carriage return, line feed then the text DATA: before inserting the body of the message to be sent.

 

Click here for a list of Settings Variables that can be used with RawSerial Carriers