Package com.tccc.kos.core.service.hardware

Class BoardIfaceLink

java.lang.Object
com.tccc.kos.core.service.hardware.HardwareLink
com.tccc.kos.core.service.hardware.BoardIfaceLink
All Implemented Interfaces:
BoardIdentifier
public class BoardIfaceLink extends HardwareLink
HardwareLink class for BoardIface devices.
Since:
1.0
Version:
2023-08-27

  • Constructor Details

    • BoardIfaceLink

      public BoardIfaceLink()

  • Method Details

    • getSession

      public BinaryMsgSession getSession()
      Return the session from the iface.

    • getType

      public String getType()
      Description copied from interface: BoardIdentifier
      Returns the type of the board.

      The hardware service uses the type to determine compatible firmware, as well as to link with adapters that are connected to the matching physical board.

      If a physical board is revised, it may keep the same type but have different variant information. The logical board is primarily concerned with the high-level feature set of the hardware, and leverages the link to the adapter to perform actual operations on the hardware. This means that a new version of a board can be spun with a different CPU and hardware changes, but so long as the protocol to the device is the same, it can still have the same board type.

      Specified by:
      getType in interface BoardIdentifier
      Specified by:
      getType in class HardwareLink

    • getInstanceId

      public String getInstanceId()
      Description copied from interface: BoardIdentifier
      Returns the instanceId of the board.

      If there is more than one instance of the board in the system, then the instanceId is used to determine which one is which. Typically, the hardware has a mechanism to identify which instance it is (via cable harness, jumper or some other mechanism), and that is the value that must be used here. For example, if a device can contain three instances of a board, and the cable harness allows the board to identify its position as "1", "2", or "3", then the logical board must use an instanceId of "1", "2", or "3" so that hardware service can match the incoming adapter link to the logical board.

      In general, there should never be more than one instance of a particular board type with the same identifierId, as there is no way to distinguish them from each other.

      If there is only one instance of the board, this will typically return null, as the hardware will not need to determine an instance ID in the adapter code.

      Specified by:
      getInstanceId in interface BoardIdentifier
      Specified by:
      getInstanceId in class HardwareLink

    • getIdentity

      public String getIdentity()
      Description copied from class: HardwareLink
      Returns the unique identifier of this board. This is used to remember that this board has been linked previously and used to determine when it has been replaced.

      This value must be unique among all other instances of this type of board. This defaults to the serial number, but can be overridden to use something like MAC address if the serial number isn't available. Unlike serial number, this will not be displayed so this can be overridden while serial number is left empty.

      Overrides:
      getIdentity in class HardwareLink

    • getMfgSerialNum

      public String getMfgSerialNum()
      Description copied from class: HardwareLink
      Returns the serial number of the board, if available. This serial number should match the manufacturing data of the board and should be used in analytic data. This should not be used for display purposes.
      Specified by:
      getMfgSerialNum in class HardwareLink