CommandFusion Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== COM Module/Card CFLink Documentation ======
The following documentation is for COM (serial port) modules and cards.

===== Port Configurations =====

The COM4 supports up to 4 COM port combinations, with RS232, RS422 and RS485 support, including flow control options.\\
\\
The default port configuration is 4 x RS232, 9600 Baud Rate, 8 Data Bits, No Parity, 1 Stop Bit, No Flow Control.\\
\\
The following tables demonstrate the possible port combinations of a single COM4 module:\\

<html>
<style type="text/css">
.rs232, .rs232H, .rs485, .rs422 {
	background-color: #fcd4b2;
	text-align: center;
	padding: 0 4px 0 4px;	
}
.rs232H {
	background-color: #c2d798;
}
.rs485 {
	background-color: #e6b7b6;
}
.rs422 {
	background-color: #c4bd94;
}
.tableheading {
	text-align: center;
	font-style: italic;
	font-size: 0.8em;
}
</style>
<table>
	<tr>
		<td colspan="4" class="tableheading">Legend:</td>
	<tr>
		<td class="rs232">RS232 without handshaking/flow control</td>
		<td class="rs232H">RS232 with RTS/CTS</td>
		<td class="rs485">RS485 half-duplex</td>
		<td class="rs422">RS485/422 full-duplex</td>
	</tr>
</table>
<table>
<tr>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>2</td>
	</tr>
	<tr>
		<td>3</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>4</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">4 x RS232<br/>&nbsp;</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>2</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS232<br/>1 x RS232 RTS/CTS</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS232 RTS/CTS<br/>&nbsp;</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp</td>
	</tr>
	<tr>
		<td>3</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>4</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS485 half-duplex<br/>2 x RS232</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS485 half-duplex<br/>1 x RS232 RTS/CTS</td>
	</tr>
</table>
</td>
</tr>
<tr>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS485 half-duplex<br/>&nbsp;</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS485 half-duplex<br/>1 x RS485/422 full-duplex</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS485/422 full-duplex<br/>&nbsp;</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS485/422 full-duplex<br/>1 x RS232 RTS/CTS</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp</td>
	</tr>
	<tr>
		<td>3</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>4</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS485/422 full-duplex<br/>2 x RS232</td>
	</tr>
</table>
</td>
</tr>
</table>
</html>
Note that when using any RS232 mode in combination with RS485 or RS422 (any duplex type), the RS232 must be on ports 3 and/or 4.\\
RS232 can never be in ports 1 or 2 when using alongside RS485 or RS422.

<html>
<table>
<tr style="background-color: #ee5b5b;">
	<td colspan="4" style="text-align: center; border-bottom: 3px solid red; font-weight: bold; color: #ffffff;">THE FOLLOWING MODES ARE INVALID!</td>
</tr>
<tr style="background-color: #f2e8e8;">
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>2</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS232<br/>1 x RS485 half-duplex</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs485">485</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS232 RTS/CTS<br/>1 x RS485 half-duplex</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td class="rs232">232</td>
		<td class="rs232">232</td>
		<td>2</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">2 x RS232<br/>1 x RS485/422 full-duplex</td>
	</tr>
</table>
</td>
<td align="center">
<table>
	<tr>
		<td>1</td>
		<td colspan="2" class="rs232H">232H</td>
		<td>&nbsp;</td>
	</tr>
	<tr>
		<td>3</td>
		<td colspan="2" class="rs422">485/422</td>
		<td>&nbsp;</td>
	</tr>
	<tr class="tableheading">
		<td colspan="4">1 x RS232 RTS/CTS<br/>1 x RS485/422 full-duplex</td>
	</tr>
</table>
</td>
</tr>
</table>
</html>

===== Queries =====

==== SPC - Query Configuration ====

The ''SPC'' (Serial Port Configuration) query is used to return the status of the port configurations for the module.

=== Data ===

<sxh cflink; light: true>
> [F2]<ID>[F3]QCOMSPC[F4]<M#>[F5][F5]

</sxh>

  * **<M#>** = The module number return the configuration for. 2 chars, uppercase 'M' followed by the module number.
    * eg. ''M1'' = Module 1, ''M4'' = Module 4.

=== Reply ===

<sxh cflink; light: true>
< [F2]<ID>[F3]RCOMSPC[F4]<M#>|<P##>:<MODE>:<BAUD>:<DATABITS>:<PARITY>:<STOPBITS>:<FLOWCONTROL>[F5][F5]

</sxh>

Each port on the COM module will be included in the reply.\\
See the definitions for all returned data in the SPC command.

=== Example ===

<sxh cflink; light: true>
// Query configuration for Module 2 in a MOD4 on CFLink ID [11]
> [F2][11][F3]QCOMSPC[F4]M2[F5][F5]
// Reply
< [F2][11][F3]RCOMSPC[F4]M2|P01:232:9600:8:N:1:0|P02:232:115200:8:N:1:0|P03:OFF:9600:8:N:1|P04:OFF:9600:8:N:1[F5][F5]
// Ports 03 and 04 are both off.
// Ports 01 and 02 are set to RS232 mode
</sxh>

===== Configuration Messages =====

==== SPC - Configure Serial Port ====

The ''SPC'' (Serial Port Configure) command is used to setup the configuration of each port within the module.\\
You can configure multiple ports at once, across multiple modules, using the Port and Module separators.

=== Data ===

<sxh cflink; light: true>
// Target device: COM4 Module
> [F2]<ID>[F3]CCOMSPC[F4]<M#>|<P##>:<MODE>:<BAUD>:<DATABITS>:<PARITY>:<STOPBITS>:<FLOWCONTROL>[F5][F5]

</sxh>

  * <M#> = The module number to configure port settings for. 2 chars, uppercase 'M' followed by the module number.
    * eg. ''M1'' = Module 1, ''M4'' = Module 4.
  * **<P##>** = Port number to configure. 3 chars, uppercase 'P' followed by the two digit port number.
    * eg. ''P01'' = Port 1, ''P02'' = Port 2.
  * **<MODE>** = The following modes are available:
    * ''0'' = Port Off
    * ''232'' = RS232 (handshaking determined via the <FLOWCONTROL> setting)
    * ''485H'' = Half-duplex RS485
    * ''4XXF'' = Full-duplex RS485 or RS422
  * **<BAUD>** = The following baud rates are available:
    * 100
    * 300
    * 600
    * 1200
    * 2400
    * 4800
    * 9600
    * 14400
    * 19200
    * 38400
    * 57600
    * 115200
    * 128000
    * 256000
  * **<DATABITS>** = Always ''8'' Data Bits
  * **<PARITY>** = The following parity types are available:
    * ''N'' = No Parity
    * ''O'' = Odd (uppercase letter 'O')
    * ''E'' = Even
  * **<STOPBITS>** = The following stop bits are available:
    * ''1'' = 1 stop bit
    * ''2'' = 2 stop bits
  * **<FLOWCONTROL>** = The following flow control (handshaking) options are available:
    * ''0'' = No flow control
    * ''1'' = Enable RTS/CTS

=== Reply ===

<sxh cflink; light: true>
< [F2]<ID>[F3]RCOMSPC[F4]<M#>|<P##>:<MODE>:<BAUD>:<DATABITS>:<PARITY>:<STOPBITS>:<FLOWCONTROL>[F5][F5]

</sxh>
The reply will contain information for each port of the module, even if only one port was changed. See the definitions for all returned data above.

=== Example ===

<sxh cflink; light: true>
// Set Port 01 to RS485 115200 Baud, 8 data bits, no parity, 1 stop bit, no flow control
// For Module 1 in a MOD4 on CFLink ID [11]
> [F2][11][F3]CCOMSPC[F4]M1|P01:4XXF:115200:8:N:1:0[F5][F5]
// Reply
< [F2][11][F3]RCOMSPC[F4]M1|P01:4XXF:115200:8:N:1:0|P02:OFF:9600:8:N:1|P03:OFF:9600:8:N:1|P04:OFF:9600:8:N:1[F5][F5]

// Port 01 is already set to RS485 mode, now we want to set port 02 to 232 mode.
// For Module 2 in a MOD4 on CFLink ID [11]
// This will break the RS485 mode, as it requires both A and B ports combined.
> [F2][11][F3]CCOMSPC[F4]M2|P02:232:115200:8:N:1:0[F5][F5]
// Reply
< [F2][11][F3]RCOMSPC[F4]M2|P01:232:9600:8:N:1:0|P02:232:115200:8:N:1:0|P03:OFF:9600:8:N:1|P04:OFF:9600:8:N:1[F5][F5]

// Error setting port mode, invalid port combination (only port 01 or 03 can be set in RS485/422 mode)
> [F2][11][F3]CCOMSPC[F4]M1|P04:4XXF:115200:8:N:1:0[F5][F5]
// Reply, when previous command was sent from a LANBridge on CFLink ID [02]
< [F2][11][F3]RCOMERR[F4]Invalid COM Mode:02:CCOMSPC:M1|P04:4XXF:115200:8:N:1:0[F5][F5]
</sxh>

===== Transmission Messages =====

==== SPW - Send Serial Data ====

The ''SPW'' (Serial Port Write) command is used to send serial data out a specific port within the module.

<sxh cflink; light: true>
// Target device: COM4 Module
> [F2]<ID>[F3]TCOMSPW[F4]<M#>|<P##>:<DATA>[F5][F5]

</sxh>

  * **<M#>** = The module number to send the data via. 2 chars, uppercase 'M' followed by the module number.
    * eg. ''M1'' = Module 1, ''M4'' = Module 4.
  * **<P##>** = Port number to send the data out via. 3 chars, uppercase 'P' followed by the two digit port number.
    * eg. ''P01'' = Port 1, ''P02'' = Port 2.
  * **<DATA>** = This is the actual data you want to send out the serial port. Data cannot contain ''[F5][F5]'' as it will strip all data from that point as per the CFLink protocol End Of Message specifier. When you want to send hex data, it must be already converted to hex within the ''<DATA>'' before sending the CFLink message to the serial port.\\
Note: Only one port can be written to per transmission command.

=== Reply ===

<sxh cflink; light: true>
// Replying device: COM4 Module
< [F2]<ID>[F3]RCOMSPW[F4]<M#>|<P##>[F5][F5]

</sxh>

If the SPW command is successful, the reply will contain the module and port number parameters used for the SPW. The data will not be echoed, in an effort to reduce bus traffic.

=== Example - Sending Serial Data ===

<sxh cflink; light: true>
// Send a command out of port 02 of a COM4 module in slot 1 of a MOD4 on CFLink ID [04]
> [F2][04][F3]TCOMSPW[F4]M1|P02:PWRON[0D][F5][F5]
< [F2][04][F3]RCOMSPW[F4]M1|P02[F5][F5]

</sxh>
=== Errors ===

  * 003 = Invalid Port Number
  * 004 = Invalid Module Number

===== Notifications =====

==== SPR - Read Serial Data ====

The ''SPR'' (Serial Port Read) reply contains any data received via a specific port within the module.\\
This reply is automatically transmitted whenever data is received.

<sxh cflink; light: true>
// Replying device: COM4 Module
< [F2]<ID>[F3]RCOMSPR[F4]<M#>|<P#>:<DATA_RECEIVED>[F5][F5]

</sxh>

  * **<M#>** = The module number that received the data. 2 chars, uppercase 'M' followed by the module number.
    * eg. ''M1'' = Module 1, ''M4'' = Module 4.
  * **<P##>** = Port number that received the data. 3 chars, uppercase 'P' followed by the two digit port number.
    * eg. ''P01'' = Port 1, ''P02'' = Port 2.
  * **<DATA_RECEIVED>** = This is the actual data that was received via the serial port.

=== Example - Receiving Serial Data ===

<sxh cflink; light: true>
// Receive data via port 1 of a COM4 module in slot 1 of a MOD4 on CFLink ID [04]
< [F2][04][F3]RCOMSPR[F4]M1|P01:MV50[0D][F5][F5]

// Receive data via port 3 of a COM4 module in slot 2 of a MOD4 on CFLink ID [04]
< [F2][04][F3]RCOMSPR[F4]M2|P03:Hello World![F5][F5]
</sxh>

===== Glossary =====

  * **Flow Control** - Flow Control is the method that a serial port uses to control the flow of traffic. COM4 only supports RTS/CTS (software) flow control. XON/XOFF is not supported
CommandFusion Wiki

User Tools

Site Tools

Page Tools
