{"type":"doc","content":[{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The RapidConnect serial protocol has a frame-based architecture. All communication between the Host and Module is facilitated by the exchange of data frames. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Serial Interface Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"The serial UART interface uses the following parameters: ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Table 1: RapidConnect Serial Parameters","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"align-start"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Baud Rate","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"115200","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Parity","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"None","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Stop Bits","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Data Bits","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"cxhtml":"INLINE

Frame Structure

Every RapidConnect frame has the structure illustrated below:

Header

The frame header is a fixed 5 bytes in length. Each byte is described in Table 2.

Table 2: Frame Header Description

Byte	Field Name	Description
0	Start of Frame	Fixed value of 0xF1; will be referred to as START_OF_FRAME throughout this document.
1	Primary Header	Defines the primary frame type.
2	Secondary Header	Identifies the command subset of the given primary frame type.
3	Frame Sequence Number	0 – 127: Host initiated transactions 128 – 255: Module initiated transactions The Frame Sequence Number enumerates a serial message exchanged between the Host and the Module, and vice versa. Use of a Frame Sequence Number for each such message is recommended. For best practice, we also recommend the Frame Sequence Number be incremented by 1 for each newly initiated message. Any transaction, whether initiated by the Host or the Module, may be acknowledged (i.e., ACK'ed) by the recipient with a response using the same Frame Sequence Number. The Frame Sequence Number is used for tracking purposes but is not a mandatory feature. If its use is not desired, it should be assigned a value of 0x00.
4	Payload Length	Defines the length of the payload of a received or transmitted frame as 0-n bytes; at the time of this writing, the maximum acceptable values for n are: Transmitted by Module – 0x7A or 122 bytes Received by Module – 0x7A or 122 bytes

Payload

Unlike the header, the payload is of variable size, ranging from 0 to n bytes; the size is based on the Payload Length field in the header. All fields contained in the payload are ordered with the least significant byte first.

The payload contains the command’s parameters. Command parameters are detailed in .

Checksum

The Checksum is a fixed two bytes in length, with the MSB indicating the End of Frame (EOF). It is calculated by summing the values of byes starting from the Primary Header to the end of the Payload. Any overflow above two bytes is discarded.

The checksum calculation (CS) is given here:

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"2d42c45f-22ac-40c0-afab-dd57b860161f"},"schemaVersion":{"value":"1"},"title":"Excerpt"}}},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Frame Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Every RapidConnect frame has the structure illustrated below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1222,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1222,"id":"26bb4c47-edd4-424a-b46b-7567aa1ff30d","collection":"contentId-110560125","type":"file","height":222}},{"type":"caption","content":[{"text":"Figure 1: RapidHA Frame Structure","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Header","type":"text"}]},{"type":"paragraph","content":[{"text":"The frame header is a fixed 5 bytes in length. Each byte is described in Table 2.","type":"text"}]},{"type":"paragraph","content":[{"text":"Table 2: Frame Header Description","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"align-start"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Byte","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Field Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Start of Frame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Fixed value of 0xF1; will be referred to as START_OF_FRAME throughout this document. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Primary Header","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Defines the primary frame type.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Secondary Header","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Identifies the command subset of the given primary frame type.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Frame Sequence Number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"0 – 127: Host initiated transactions ","type":"text"}]},{"type":"paragraph","content":[{"text":"128 ","type":"text"},{"text":"– ","type":"text"},{"text":"255: Module initiated transactions ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The Frame Sequence Number enumerates a serial message exchanged between the Host and the Module, and vice versa. Use of a Frame Sequence Number for each such message is recommended.","type":"text"}]},{"type":"paragraph","content":[{"text":"For best practice, we also recommend the Frame Sequence Number be incremented by 1 for each newly initiated message.","type":"text"}]},{"type":"paragraph","content":[{"text":"Any transaction, whether initiated by the Host or the Module, may be acknowledged (i.e., ACK'ed) by the recipient with a response using the same Frame Sequence Number.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Frame Sequence Number is used for tracking purposes but is not a mandatory feature. If its use is not desired, it should be assigned a value of 0x00. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Payload Length","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Defines the length of the payload of a received or transmitted frame as 0-n bytes; at the time of this writing, the maximum acceptable ","type":"text"}]},{"type":"paragraph","content":[{"text":"values for n are:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Transmitted by Module – 0x7A or 122 bytes","type":"text"}]},{"type":"paragraph","content":[{"text":"Received by Module – 0x7A or 122 bytes ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Payload","type":"text"}]},{"type":"paragraph","content":[{"text":"Unlike the header, the payload is of variable size, ranging from 0 to n bytes; the size is based on the Payload Length field in the header. All fields contained in the payload are ordered with the least significant byte first.","type":"text"}]},{"type":"paragraph","content":[{"text":"The payload contains the command’s parameters. Command parameters are detailed in ","type":"text"},{"text":"Frame Payload Definitions","type":"text","marks":[{"type":"link","attrs":{"href":"https://mmbnetworks.atlassian.net/wiki/spaces/SPRC2/pages/110561750"}},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Checksum","type":"text"}]},{"type":"paragraph","content":[{"text":"The Checksum is a fixed two bytes in length, with the MSB indicating the End of Frame (EOF). It is calculated by summing the values of byes starting from the Primary Header to the end of the Payload. Any overflow above two bytes is discarded.","type":"text"}]},{"type":"paragraph","content":[{"text":"The checksum calculation (CS) is given here:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":238,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":238,"id":"7c9e457f-47a6-4444-be71-9912a6666d66","collection":"contentId-110560125","type":"file","height":136}}]}]}],"version":1}}}},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}]}],"version":1}

Parameter	Value
Baud Rate	115200
Parity	None
Stop Bits	1
Data Bits	8

Protocol Overview

Serial Interface Parameters