Additional apps

Veronte UDP Telemetry CLI

Veronte UDP Telemetry CLI is an additional command-line tool which allows Veronte Link to send Autopilot 1x telemetry over UDP.

Download

Once the Veronte Autopilot 1x has been purchased, a GitHub release should be created for the customer with the application.

To access to the release and download the software, read the Releases section of the Joint Collaboration Framework manual.

Installation

To install Veronte UDP Telemetry CLI on Windows just execute “veronte-udp-telemetry-cli.exe” and follow the indications of the Setup Wizard.

Note

If users have any problems with the installation, please disable the antivirus and the Windows firewall. Disabling the antivirus depends on the antivirus software.

To disable the firewall, go to “Control Panel” \(\rightarrow\) “System and Security” \(\rightarrow\) “Windows Defender Firewall” and then, click on “Turn windows Defender Firewall on or off”.

../_images/firewall-windows-menu.png

Windows Defender Firewall

../_images/turn-off-firewall.png

Windows Defender Firewall: Customize Settings

Configuration

The following sections detail the steps to configure the Veronte system to transmit telemetry UDP messages through Veronte UDP Telemetry CLI, after it is installed.

1x PDI Builder

First, in 1x PDI Builder, the intended variables to send must be added to the corresponding telemetry vector.

To do this:

  1. Go to Telemetry menu \(\rightarrow\) Telemetry panel.

  2. By clicking the corresponding add button, add the desired telemetry variables to one of the telemetry vectors Data to VApp.

    ../_images/add_variable.png

    Add variables

    Note

    For further information about this Telemetry menu, please refer to the Telemetry section of 1x PDI Builder user manual.

  3. Configure the Data to VApp vector where the variables have been added as follows:

    • Frequency: Desired frequency of data transmission

    • Address: App 2 (Veronte apps address)

    Note

    Hash parameter is not configurable, it is automatically calculated by the system based on the telemetry vector configured by the user. It is a hexadecimal representation of the CRC of the fieldset.

    ../_images/data_vector_parameters.png

    Data vector parameters

  4. Save the changes by clicking save button.

Veronte UDP Telemetry CLI

Veronte UDP Telemetry CLI has a configuration file (tudp.config) in which users must specify which telemetry variables to send. Once the app is installed, this file can be found in C:/Users/user/AppData/Roaming/VeronteUDPTelemetryCli:

../_images/configuration_file.png

Configuration file

Caution

On Windows, the AppData folder is hidden by default, if it is not visible in C:\Users\user, users can “show” it by checking the “Hidden Items” checkbox:

../_images/appdata.png

Windows File Explorer

In tudp.config, there is a table where users must fill the following information for each telemetry variable to send:

Note

The variables to configure must match the ones added in 1x PDI Builder.

  • MULT: Scale factor

  • OFFSET

  • TVAR: Type of variable coding

    • byte: Unsigned byte (0 to 255)

    • bit: N bits

    • UInt16: Unsigned 16-bit integer (0 a 65.536)

    • Int16: Signed 16-bit integer (-32.768 to 32.768)

    • UInt32: Unsigned 32-bit integer (-2.147.483.648 to 2.147.483.648)

    • Int32: Signed 32-bit integer (0 to 4.294.967.295)

    • Float: 32 bit single-precision floating-point ( \(3.4028237 \cdot 10^{38}\) to \(1.175494 \cdot 10^{-38}\) )

  • UAV: Serial Number of the Autopilot 1x from which the variables are going to be sent.

  • VERVAR: Type of variable in Veronte system

    • RVAR: Real variables

    • UVAR: Integer variables

    • BIT: Bit variables

  • ID: Identifier of the variable in Veronte. Refer to the List of variables section of 1x Software Manual for Index-Variable correspondence or check it on the Variables panel of the UI menu of 1x PDI Builder app.

  • UNIT: Index of the unit of measure of the variable. Please, see the Index-Unit correspondence table for detailed information.

This a configuration example for Relative Timestamp, Longitude and Latitude variables:

../_images/configuration_table.png

Relative Timestamp, Longitude and Latitude example

Index-Unit correspondence table

Unit ID

Unit

0

m/s

1

kt

2

km/h

3

mph

4

ft/s

121

ft/m

321

mm/s

5

m

6

km

62

mm

63

cm

7

mi

8

NM

9

yd

10

ft

11

in

12

m/s²

13

ft/s²

14

in/s²

15

g (gravity)

202

rad

16

rad [\(-\pi, \pi\)]

203

rad [0, \(2\pi\)]

205

º

17

º [-180,180]

101

º [0,360]

102

º ‘ ‘’

103

º ‘ ‘’ (N/S)

104

º ‘ ‘’ (E/W)

21

T

160

nT

23

G

22

mG

24

V

25

mV

26

A

27

mA

340

kA

28

Pa

29

kPa

30

bar

31

mbar

32

psi

33

mmHg

34

at

35

atm

147

Pa²

36

K

37

ºC

38

ºF

39

s

120

Time

40

min

41

h

330

ns

108

\(\mu\) s

109

ms

42

rad/s

117

º/s

43

rad/min

44

rad/h

45

rps

46

rpm

47

rph

57

m³/s

58

gal/s

54

gal/h

59

l/s

55

l/h

56

60

x1

64

%

61

pkts/s

105

Hz

106

mHz

107

kHz

140

Bd

141

kBd

142

MBd

110

111

cm²

112

mm²

113

km²

114

mile²

115

ft²

116

yd²

118

bit

119

byte

131

KB

132

GB

122

kg

123

g

124

tonnes

125

lbs

126

oz

127

N

128

kN

129

lbf

130

pdl

134

rad/s²

135

rad/min²

136

rad/h²

137

º/s²

138

º/m²

139

º/h²

329

rpm/s

143

144

(m/s)²

145

(cm/s)²

146

(mm/s)²

327

\(\Omega\)

328

Henrios

322

watios

323

kW

324

Kgm/s

325

erg/s

326

cv

331

332

dm³

333

mm³

334

L

335

mL

Operation

This section details the steps to transmit telemetry UDP messages through Veronte UDP Telemetry CLI.

Sending UDP messages

Veronte UDP Telemetry CLI connects to Veronte Link to send the previously configured Autopilot 1x telemetry via UDP messages. For this reason, the connection between the autopilot and Veronte Link must be properly established, and Veronte Link needs to be opened.

Note

For more information about this connection, please refer to Connection - Operation section of this manual.

These are the options to send the configured variables:

  1. Launching Veronte UDP Telemetry CLI by double-clicking on the App shortcut or the .exe file:

    ../_images/shortcut_icon.png

    Veronte UDP Telemetry CLI shorcut

    This will send the UDP messages with the following default configuration:

    • Host IP: 127.0.0.1

    • UDP port: 3000

    • Frequency: 10 Hz

    Note

    These installation files location will vary depending on the location selected during installation. Note that Veronte UDP Telemetry CLI Installer .exe is not the Veronte UDP Telemetry CLI .exe to launch.

  2. Launching Veronte UDP Telemetry CLI .exe from terminal, where it is possible to specify the parameters of the trasmission using the following command-line options:

    • - u: IP address

    • - p: UDP port

    • - f: Desired frequency of data transmission (Hz)

    This is an example:

    ../_images/launching_from_terminal.png

    Launching from terminal example

The expected outcome is the following:

../_images/succesful_connection.png

Expected outcome