Difference between revisions of "SHIP:Node:linkset"

From Serious Documentation
Jump to: navigation, search
(Examples)
Line 28: Line 28:
 
== Examples ==
 
== Examples ==
  
Adding two linksets to the example in [[SHIP:Node:link|link] reference:
+
Adding two linksets to the example in [[SHIP:Node:link|link]] reference:
  
 
[[File:SHIPTide-linkExample1.png|400px|border|center|Example link with two linksets]]
 
[[File:SHIPTide-linkExample1.png|400px|border|center|Example link with two linksets]]
  
 
In this example, our GUI is acting as a Modbus Slave attached to UART0, potentially one of many on the communications channel.  This physical channel could be, for instance, a multi-drop RS485 network with many slaves of which our [[SIMs|SIM]] is only one.  Our GUI, because it has the two linksets at ID #1 and #13 created, will respond as if it were two of those slaves on the network.
 
In this example, our GUI is acting as a Modbus Slave attached to UART0, potentially one of many on the communications channel.  This physical channel could be, for instance, a multi-drop RS485 network with many slaves of which our [[SIMs|SIM]] is only one.  Our GUI, because it has the two linksets at ID #1 and #13 created, will respond as if it were two of those slaves on the network.

Revision as of 14:58, 25 November 2012

Within a given link, there may be one or more linkset nodes. Each linkset encompasses all the traffic between two endpoints in a link.

For slave link types of master/slave protocols (for example the MODBUS_SLAVE_RTU), the link may be representing one or more Modbus slaves within the SHIPEngine environment. Even though the protocol is running on a single physical communications channel (e.g. UART0), each linkset within the link can act as one of a number of independent virtual slaves.

For master link types of of master/slave protocols (for example MODBUS_MASTER_ASCII) you may want to address multiple slaves on the channel. Each slave would be identified by a linkset with the slave ID set appropriately.

Parent Nodes

The following nodes are permitted to hold this node:

Child Nodes

The following nodes are permitted to exist within this node:

Properties

Property Name Description
name A unique linkset name within the link
id Some protocols require the endpoint to have an ID number assigned
channel A port name (e.g. UART0)

Examples

Adding two linksets to the example in link reference:

Example link with two linksets

In this example, our GUI is acting as a Modbus Slave attached to UART0, potentially one of many on the communications channel. This physical channel could be, for instance, a multi-drop RS485 network with many slaves of which our SIM is only one. Our GUI, because it has the two linksets at ID #1 and #13 created, will respond as if it were two of those slaves on the network.