4.2.1. Echo¶
This command prints every User Data received in a human readable way. The information shown with this command is real-time data that is being received by Fast DDS Spy. In order to stop the command, press enter and the CLI will finish showing the data received.
Note
This is a real-time command that will not stop until enter is pressed.
4.2.1.1. Key-words¶
These are the key-words recognize as this command:
echo show print s S.
4.2.1.2. Data Type discovered¶
In order for a Topic to be printable by the application, the Fast DDS Spy requires to know the data type of such topic. The information whether the topic data type is already discovered be the application can be shown by using Topic command.
4.2.1.3. Arguments¶
Echo command supports different combination of arguments:
4.2.1.3.1. Topic name¶
When a topic name is given, the information shown is the data received in real-time in the topic specified. The output format is as follows: Simple Data format.
4.2.1.3.2. Topic name with wildcards¶
When a topic name is provided with wildcards (*), the command will display real-time information for all topics whose names match the given filter.
For example, if you enter sensor_*, the command will print data from all topics starting with sensor_, such as sensor_temperature, sensor_humidity, etc.
4.2.1.3.3. Topic name + Verbose¶
Giving a topic name and the the verbose argument the output is the data received in real-time with additional meta-information as the topic name, the source timestamp, and the source DataWriter Guid. Data is printing using Verbose Data format.
4.2.1.3.4. Topic name wildcard¶
When a topic name is provided with wildcards (*) and the verbose argument, the command displays detailed real-time information and meta-information for all topics that match the given filter.
4.2.1.3.5. All¶
This argument prints all topics which Data Type has been discovered. Data is printing using Verbose Data format.
4.2.1.4. Output Format¶
Note
The format of the data printed is not YAML. The correct YAML format will come in future releases.
The data information is retrieved in 2 formats depending on the verbose option.
4.2.1.4.1. Simple Data format¶
Only shows the data, by
---
<field name>: <value>
...
---
4.2.1.4.2. Verbose Data format¶
topic: <topic name> [<topic data type name>]
data: <Guid>
timestamp: <YYYY/MM/DD hh:mm:ss>
data:
---
<field name>: <value>
...
---
4.2.1.5. Example¶
Let’s assume we have a DDS network where 2 ShapesDemo applications are running.
This would be the expected output for the command show Circle:
---
color: GREEN
x: 168
y: 125
shapesize: 30
---
---
color: GREEN
x: 173
y: 121
shapesize: 30
---
...
This would be the expected output for the command show Circle verbose:
topic: Circle [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.6.2
timestamp: 2023/03/27 09:35:23
data:
---
color: GREEN
x: 72
y: 125
shapesize: 30
---
topic: Circle [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.6.2
timestamp: 2023/03/27 09:35:24
data:
---
color: GREEN
x: 66
y: 120
shapesize: 30
---
...
This would be the expected output for the command datas 01.0f.22.ba.3b.47.ab.3c.00.00.00.00|0.0.1.c1:
topic: Square [ShapeType]
data: 01.0f.44.59.da.57.de.ec.00.00.00.00|0.0.2.2
timestamp: 2023/03/27 09:35:25
data:
---
color: BLUE
x: 158
y: 70
shapesize: 20
---
topic: Triangle [ShapeType]
data: 01.0f.44.59.21.58.14.d2.00.00.00.00|0.0.1.2
timestamp: 2023/03/27 09:35:26
data:
---
color: YELLOE
x: 93
y: 75
shapesize: 25
---
...