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 interface	The network interface to be used by the transmitter. If set to ANY, this field is ignored.
Receiver network interface	The 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 Point	Direction	Description
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 Point	Direction	Description
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.