Reads time at which the session's interface started its integration with the network cluster. The time is returned as a LabVIEW absolute timestamp. local time communicating uses the local timescale. network time communicating and network synced are applicable only for an Ethernet interface.


icon

Inputs/Outputs

  • cgenclassrntag.png session in

    session in is the session to read. This session is selected from the LabVIEW project or returned from the XNET Create Session VI.

  • cerrcodeclst.png error in (no error)

    The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

  • igenclassrntag.png session out

    session out is the same as session in, provided for use with subsequent VIs.

  • iatrn.png local time start

    local time start returns the interface start time as a LabVIEW absolute time, using the local timescale.

    If the interface is not started when the XNET Read (State Time Start) VI is called, local time start returns an invalid time (0).

  • ierrcodeclst.png error out

    The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

  • iatrn.png network time start

    network time start Ethernet only. Returns the interface start time as a LabVIEW absolute time, using the network timescale. The network time start timestamp is captured simultaneously with the local time start timestamp.

    The network time start output is not applicable for CAN, FlexRay, and LIN and returns an invalid time (0).

    This output is optional.

  • ibool.png network synced

    network synced Ethernet only. Contains the value of the Synced property at the time that both timestamps are acquired, to specify whether the network time current timestamp is synchronized to the network (true) or not (false).

    The network synced output is not applicable for CAN, FlexRay, and LIN and returns a value of false.

    This output is optional.

  • Description

    You can use the XNET Read (State Time Start) VI with any XNET session mode. Because the time is associated with the interface, it can apply to multiple sessions.

    The XNET Read (State Time Start) VI returns time as a LabVIEW absolute timestamp data type.

    Your application typically starts the interface simply by calling an XNET Read VI or XNET Write VI, because the XNET Session Auto Start? property is true by default. If you set Auto Start? to false, you start the interface using the XNET Start VI. If you use the XNET Connect Terminals VI to import a start trigger for the interface, all sessions for that interface wait for the trigger to occur before starting the interface.

    Once the interface starts, this VI captures and returns the time. Unless you connect a start trigger, this time generally is known, so this VI may not be useful.

    After the XNET interface starts, the communication controller begins to integrate with ECUs in the network. After this integration is complete, the time is captured and available using the XNET Read (State Time Comm) VI. That time often is useful for FlexRay, because it indicates the time when true communication began.