Project

General

Profile

History

gps component

Ports

state (out)

Data structure

  • struct ::or_pose_estimator::state state

    • struct ::or::time::ts ts

      • long sec

      • long nsec

    • boolean intrinsic

    • optional< struct ::or::t3d::pos > pos

      • double x

      • double y

      • double z

    • optional< struct ::or::t3d::att > att

      • double qw

      • double qx

      • double qy

      • double qz

    • optional< struct ::or::t3d::vel > vel

      • double vx

      • double vy

      • double vz

    • optional< struct ::or::t3d::avel > avel

      • double wx

      • double wy

      • double wz

    • optional< struct ::or::t3d::acc > acc

      • double ax

      • double ay

      • double az

    • optional< struct ::or::t3d::aacc > aacc

      • double awx

      • double awy

      • double awz

    • optional< struct ::or::t3d::pos_cov > pos_cov

      • double cov[6]

    • optional< struct ::or::t3d::att_cov > att_cov

      • double cov[10]

    • optional< struct ::or::t3d::att_pos_cov > att_pos_cov

      • double cov[12]

    • optional< struct ::or::t3d::vel_cov > vel_cov

      • double cov[6]

    • optional< struct ::or::t3d::avel_cov > avel_cov

      • double cov[6]

    • optional< struct ::or::t3d::acc_cov > acc_cov

      • double cov[6]

    • optional< struct ::or::t3d::aacc_cov > aacc_cov

      • double cov[6]

info (out)

Data structure

  • struct ::gps::solution_s info

    • struct ::or::time::ts ts

      • long sec

      • long nsec

    • struct ::or::time::ts utc

      • long sec

      • long nsec

    • enum ::gps::fix_s fix ∈ { fix_none, fix_interp, fix_single, fix_diff, fix_rtk_float, fix_rtk, fix_fixed }

    • unsigned short sats

    • struct ::gps::llh_s llh

      • double latitude

      • double longitude

      • double height

    • struct ::gps::enu_s pos

      • double east

      • double north

      • double up

    • struct ::gps::enu_s pos_sigma

      • double east

      • double north

      • double up

    • struct ::gps::enu_s vel

      • double east

      • double north

      • double up

    • struct ::gps::enu_s vel_sigma

      • double east

      • double north

      • double up

Services

get_param (attribute)

Outputs

  • struct ::gps::param_s param

    • string<32> model

    • double rate

    • double ecutoff

    • struct ::gps::noise_s noise

      • double posxy_sigma

      • double posz_sigma

      • double velxy_sigma

      • double velz_sigma

get_last_fix (attribute)

Outputs

  • struct ::gps::ids::fix_s fix

    • double remain

    • unsigned long samples

    • struct ::gps::llh_s llh

      • double latitude

      • double longitude

      • double height

    • struct ::gps::enu_s pos

      • double east

      • double north

      • double up

    • struct ::gps::enu_s sigma

      • double east

      • double north

      • double up

set_noise (attribute)

Inputs

  • struct ::gps::noise_s noise

    • double posxy_sigma (default "0") X,Y position minimum standard deviation (m)

    • double posz_sigma (default "0") Z position minimum standard deviation (m)

    • double velxy_sigma (default "0") X,Y velocity minimum standard deviation (m/s)

    • double velz_sigma (default "0") Z velocity minimum standard deviation (m/s)

Set minimum noise on position and velocity

connect (activity)

Inputs

  • string<64> serial (default "/dev/ttyUSB0") Serial device

  • unsigned long baud (default "115200") Baud rate
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev

  • exception ::gps::e_baddev

    • string<256> dev
Context

  • In task io

Connect to the hardware

disconnect (activity)

Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what
Context

  • In task io

Disconnect from the hardware

set_rtk_port (activity)

Inputs

  • unsigned short port (default "8083") RTK server UDP port
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what
Context

  • In task io

Configure the UDP port for RTK correction streaming.

RTK data (see send_rtcm (activity)) is streamed from this source UDP port. Requests for RTK data from remote components (see connect_rtk (activity)) should thus be made to this port number.

connect_rtk (activity)

Inputs

  • string<64> host (default "gps-base") RTK server hostname

  • unsigned short port (default "8083") RTK server UDP port
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev
Context

  • In task io

Receive RTK data from a remote gps-genom3 component.

In mobile station mode, the component can be configured to accept RTK data from a remote gps-genom3 component configured in base station mode.

This service asks the remote host identified by its name or IP number (in number-and-dots notation) and the port number (see set_rtk_port (activity)) to start streaming any available RTK data to this component.

Note If RTK data is received from an unknown host that was not explicitly connected with this service, the component will print a diagnostic message on stderr and ignore the data.

set_reference (function)

Inputs

  • struct ::gps::llh_s reference

    • double latitude (default "43.5622") geodetic latitude (deg)

    • double longitude (default "1.4773") longitude (deg)

    • double height (default "206.233") height above WGS84 ellipsoid (m)
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

Set the ENU reference position.

The position published in the state (out) port is computed as ENU (east, north, up) coordinates relative to the given global reference in LLH coordinates (latitude, longitude, height above ellipsoid).

get_reference (attribute)

Outputs

  • struct ::gps::llh_s ref

    • double latitude

    • double longitude

    • double height

Get the ENU reference position.

See set_reference (function).

unfix (activity)

Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev
Context

Unset FIX mode.

This service makes the component stop acting as a fixed base station and puts it back in mobile receiver mode. See fix (activity) and fix_here (activity).

fix (activity)

Inputs

  • struct ::gps::llh_s llh

    • double latitude geodetic latitude (deg)

    • double longitude longitude (deg)

    • double height height above WGS84 ellipsoid (m)

  • struct ::gps::enu_s sigma

    • double east Local standard deviation on the longitude (m)

    • double north Local standard deviation on the latitude (m)

    • double up Standard deviation on the height (m)
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev

  • exception ::gps::e_nofix
Context

Set FIX mode at given position.

After invoking this service, the component is configured in fixed base station mode. In particular, it will start providing RTCM corrections to clients requesting it (see send_rtcm (activity)).

Depending on the underlying hardware, the given llh position must be accurate enough so that the receiver can actually switch to base station mode. The required accurarcy must typically be better than 10 meters. The precision given in sigma should reflect the estimated precision of the llh position, although this precision is not used by the hardware.

The fix member of the info (out) port will switch to fix_fixed mode when the connected hardware will actually have successfully switched to the base station mode.

fix_here (activity)

Inputs

  • double avg_time (default "600") Position average duration (s)
Outputs

  • struct ::gps::llh_s llh

    • double latitude

    • double longitude

    • double height

  • struct ::gps::enu_s pos

    • double east

    • double north

    • double up

  • struct ::gps::enu_s sigma

    • double east

    • double north

    • double up
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev

  • exception ::gps::e_nofix
Context

Average current position and set FIX mode.

This service is similar to fix (activity), but uses the current receiver position as the desired fixed position. The current position is first averaged for avg_time number of seconds and the fix (activity) service is then invoked with the averaged result. The receiver should not be moved during the averaging period.

When successful, the service also returns the averaged position. It can be later reused as a parameter of the fix (activity) service to save the averaging time and quickly switch to the base sation mode when the receiver position is already known.

The averaging time should be long enough so that a sufficient precision is obtained on the position. Depending on the setup quality, this can take as much as several dozens of minutes. The obtained precision is always returned in the sigma output parameter. This result should be checked and the averaging done for a longer time if the precision is not deemed satisfactory.

send_rtcm (activity)

Inputs

  • unsigned short rtcmid (default "1") RTCM message id

  • double period (default "1") Period (s)

  • double offset (default "0") Offset (s)
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev
Context

  • In task io

Send new RTCM corrections.

The RTCM message identified by rtcmid is streamed on the UDP port set in set_rtk_port (activity) (by default 8083) at the frequency corresponding to period.

The messages are sent at UTC timestamps multiple of period, plus an offset. For instance, to stream data at 1 second afer every minute, set the period to 60 and offset to 1.

Not all periods and messages are supported by all devices. In case of an unsupported setting, the e_sys/EINVAL exception will be raised.

Note RTCM messages will only be streamed when the device is configured in base station mode. This requires fixed position to be set with fix (activity) or fix_here (activity).

cancel_rtcm (activity)

Inputs

  • unsigned short rtcmid (default "1") RTCM message id
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev
Context

  • In task io

Stop sending and ignore certain RTCM messages.

In base station mode, the RTCM message identified by rtcmid are not streamed anymore. See send_rtcm (activity).

In mobile station mode, any incoming RTCM message with this rtcmid will be silently ignored. This is useful to precisely configure what the hardware device will see, especially to filter out messages supported by the hardware but that are not wanted in a specific configuration. It is also useful to suppress diagnostic messages about incoming messages that are not supported by the hardware.

enable_rtcm (function)

Inputs

  • unsigned short rtcmid (default "1") RTCM message id
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

Accept certain RTCM messages.

In mobile station mode, accept incoming RTCM message with this rtcmid. This is ony useful if a message has been previously cancelled. See cancel_rtcm (activity).

monitor_fix (activity)

Inputs

  • enum ::gps::monitor_op_s trigger (default "::gps::monitor_above") Type of event expected ∈ { monitor_above, monitor_below }

  • enum ::gps::fix_s target (default "::gps::fix_rtk_float") Fix quality threshold ∈ { fix_none, fix_interp, fix_single, fix_diff, fix_rtk_float, fix_rtk, fix_fixed }
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what
Context

  • In task io

Monitor fix quality changes.

This service waits until the fix quality is at least target (for trigger equal to monitor_above) or worse than target (for trigger equal to monitor_below).

rtk_stats (function)

Outputs

  • struct ::gps::rtcm_stats_s stats

    • sequence< struct ::gps::rtcm_sentid > sent

      • unsigned short rtcmid

      • double period

      • double offset

      • unsigned long out

    • sequence< struct ::gps::rtcm_recvid > recv

      • unsigned short rtcmid

      • unsigned long in

    • sequence< unsigned short > ignored

    • unsigned long inbytes

    • unsigned long inpkts

    • unsigned long outbytes

    • unsigned long outpkts

    • unsigned long dropbytes

    • unsigned long droppkts
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

  • exception ::gps::e_nodev

Log RTK configuration and statistics.

log (function)

Inputs

  • string<64> path (default "/tmp/gps.log") Log file name

  • unsigned long decimation (default "1") Reduced logging frequency
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what

Log solution

log_stop (function)

Stop logging

log_info (function)

Outputs

  • unsigned long miss Missed log entries

  • unsigned long total Total log entries

Show missed log entries

Tasks

io

Context
Throws

  • exception ::gps::e_sys

    • short code

    • string<128> what