GNSS
DPYGNSSTOOL Linux Programmer's Manual DPYGNSSTOOL DESCRIPTION dpygnsstool : Tool used to read GNSS messages. Moreover, it is used to configure several parameters of GNSS module. SYNOPSIS dpygnsstool [-h/ --help] dpygnsstool [-tv / --toolversion] dpygnsstool [-p/ --position] dpygnsstool [-u/ --updates] dpygnsstool [-up/ --updatesper] dpygnsstool [-t/ --time] dpygnsstool [-i/ --info] <option> dpygnsstool [-s/ --status] dpygnsstool [-pwr/ --power] <option> dpygnsstool [-sr/ --softreset] <option> dpygnsstool [-hr/ --hardreset] dpygnsstool [-hr/ --hardreset] dpygnsstool [-ss / --simulatestart] <option> dpygnsstool [-st / --simulatestop] OPTIONS -h / --help : Print help command information. -tv / --toolversion : Print tool version. -u / --updates : Gets position updates. -up / --updatesper : Gets position updates in a permanent mode. -p / --position : Gets last stored position. -s / --status : Gets the current status of the GNSS module. -sp / --statusper : Gets the current status of the GNSS module in a permanent mode. -t / --time : Gets current time obtained by the module. -i / --info <option> : Gets GNSS module related information. Description: <option> : Information options. Possible values are: <-m/ --model> : Retrieves GNSS model. <-f/ --manuf> : Retrieves GNSS manufacturer. <-w/ --fw> : Retrieves GNSS firmware version. <-p/ --protocol> : Retrieves GNSS module protocol version. -gpwr / --getpower : Gets GNSS module power state. -spwr / --setpower <option> : Sets GNSS module power state. Description: <option> : Power states options. Possible values are: <-d/ --disable> : Disables all GNSS functionalities. <-s/ --save> : Sets the GNSS power save mode. <-e/ --enable> : Enables the GNSS functionalities. -sr / --softreset <option> : Performs a specific software reset of the GNSS module. Description: <option> : Performs a specific software reset of the GNSS module. Possible values are: <-hot/ --hotstart> : Performs a hotstart reset. <-warm/ --warmstart> : Performs a warmstart reset. <-cold/ --coldstart> : Performs a coldstart reset. -hr / --hardreset : Performs a hardware reset of the GNSS module. -ss / --simulatestart <option>: Starts a simulation session given a position simulation file which will be read in constant periods of time. Description: <--custom_format> <simulation_file_path> : Simulate positions given they are stored in the file according to the format explained below. 1 2 3 4 5 6 7 8 9 10 11 | | | | | | | | | | | F;xx;xx;hh:mm:ss;dd/mm/yyyy;dd.xxxxxx;ddd.xxxxxx;aaa.xxxx;HH.HHH;sss.sss;ccc.ccc; 1) FIX STATUS [0,5] 0 = NO_FIX 1 = AUTONOMOUS_FIX 2 = DIFFERENTIAL_FIX 3 = RTK_FIXED 4 = RTK_FLOAT 5 = ESTIMATED_DEAD_RECKONING_FIX 2) Satellites in use 3) Satellites in view 4) UTC Time (hh:mm:ss) 5) UTC Date (dd/mm/yyyy) 6) Latitude (decimal degrees) [+90.000000,-90.000000] 7) Longitude (decimal degrees) [180.000000,-180.00000] 8) Altitude (m) [-9999.9,17999.9] 9) Horizontal dilution of precision (HDOP) 10) Speed (km/h) 11) Course over the ground (degrees) [0,360] A valid example would be: [F;xx;xx;hh:mm:ss;dd/mm/yyyy;dd.xxxxxx;ddd.xxxxxx;aaa.xxxx;HH.HHH;sss.sss;ccc.ccc] 1;04;11;19:00:22;23/01/2019;-4.71731956;41.5166031;1300;01.0;100.00;320; <--nmea> <simulation_file_path> : Simulate positions given they are stored in the file according to the NMEA format. Remark: Every sentence should be located in a single line for the simulation to work properly. Warning: Please, keep in mind that in order to change between simulation types or modes, simulation mode should be stopped first. -st / --simulatestop : Stops the current simulation session, if any. This makes the gnss_service return to full operation mode, where a real GNSS is used. EXAMPLES dpygnsstool --updates dpygnsstool -p dpygnsstool -i --manuf dpygnsstool --simulatestart --custom_format /mntDAT/custom_position_file.txt FILES JSON Configuration file : /mntSFS/gmvCNF/gnss_conf.json BUGS SEE ALSO AUTHORS Deepsy Team
