Documentation Home Page RT-LAB Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

DIANE (RTDP)

Description

The DIANE driver enables the transmission and reception of data of one UDP stream over an Ethernet physical link. The driver must be configured using a configuration file in an XML format. 

  • For transmission, the messages are sampled at each timestep of the model and pushed in the datagram. The datagram is sent once it is full or when the configurable timeout expires.
  • For reception, all messages received in the datagram are pushed to the model. Each sample of the same message group is displayed in the model in the same order as it was received in the datagram.

Supported Features

The following is a list of the features supported by the driver:

  • One UDP stream:
    • Only one UDP stream can be transmitted and/or received at one time
    • The stream can be configured with a multicast IP address
  • User-configurable ports, IP addresses, and network interfaces
    • Any valid port, IP address  or network interface can be selected
  • Analog and discrete message types supported
  • A producer can be selected to be in both transmission and reception modes
  • Support for oversampling

Configuration

The driver is configurable only via the RT-LAB interface. Users can import a valid XML file containing producer information via the DIANE importer wizard.

Click the DIANE Importer button to access the wizard.

Select the file to import. 

If the file is valid, you should see the table populated with a list of Producers.

Enable the producers and modify the ports and IP addresses as needed. The yellow fields are modifiable. 

Choose the mode you would like for the producer. Options are transmission/reception/both.

Click Next to see the list of messages for each producer. The sampling rate for the messages can be configured by modifying the Number of series field

Click Next to see the parameters for the messages.

Click Finish, then Ctrl + S to save.

Expand the property tree window to see a list of the data points.

General Configuration

The first parameters to be configured are found below:

Use an RT core for asynchronous computation
  • If set to true, the driver reserves a real-time CPU core for its communication system and can handle a bigger amount of data.
  • If set to false, the communication system defaults to core 0.
Diane transmitter timeout (ns)This defines the time the transmitter has to completely send the datagram. If the timeout is too small the 6th bit of the datagram status field will be raised. 

Advanced Parameters

This tab sets the advanced parameters defined below.

Inter-process FIFO depth for the transmitter

FIFO size for the transmitter to conserve data.

  • If the model timestep is very small, it can be useful to have a bigger depth to avoid data loss.
  • If the depth is too small for the timestep, a warning occurs on execute, and the Saturated data point is set to 1.
Inter-process FIFO depth for the receiver

FIFO size for the receiver to conserve data.

  • If the model timestep is very small, it may be useful to have a bigger depth.
  • If the depth is too small for the timestep, a warning occurs on reset.
Transmitter network interfaceThe network interface to be used by the transmitter. 
If set to ANY, this field is ignored.
Receiver network interfaceThe network interface to be used by the receiver. 
If set to ANY, this field is ignored.

Status Connection Points

The next table shows the data point for each message group imported.

Data PointDirectionDescription
HPF_10s
  • Model Input for the receiver
  • Model Output for the transmitter
Timestamp of the message with a resolution of 10 seconds.
Hpf_ms
  • Model Input for the receiver
  • Model Output for the transmitter
Timestamp of the message with a resolution of milliseconds.

HHR_us

  • Model Input for the receiver
  • Model Output for the transmitter

Timestamp of the message with a resolution of microseconds.

Disable  transmission 
  • Model Output for the transmitter

Stop transmitting messages for this group. 

This connection point allows the user to reduce the transmission rate of a given message group.

If the Disable transmission is set to 1 during a timestep, the data corresponding to this step is not sent.

A connection with the value 0 must be done with this data point otherwise the message group won't be sent.


The next table shows the data point present for each box configured. 


Data PointDirectionDescription
Time

Model Input for the receiver

Model Output for the transmitter

Timestamp of the Diane datagram
Synchronized

Model Input for the receiver

Model Output for the transmitter

  • 0: Producer is synchronized
  • 1: Producer is not synchronized

This signal corresponds to bit 0 of the status in the datagram block.

Saturated

Model Input for the receiver

Model Input for the transmitter

  • 0: Producer is saturated. Possibility of data loss
  • 1: Producer is not saturated

Increasing the Inter-process FIFO depth for the transmitter may help to overcome this issue.

This signal corresponds to bit 1 of the status in the datagram block.

Timeout

Model Input for the receiver

Model Input for the transmitter

  • 0: No timeout during data transmission
  • 1: Timeout during data transmission

This signal corresponds to bit 6 of the Status in the datagram block.

Sequence number

Model Input for the receiver

Model Output for the transmitter

The sequence number for the block.

Number of blocks sent

Model Input for the transmitter

The number of times the block was transmitted.

Connections

The image below shows examples of connection points for the DIANE I/O interface.

Once the driver has been configured as desired and associated to the proper model subsystem, the user needs to connect points in the model to points in the driver by using the corresponding RT-LAB GUI.


OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter