UM-0086-A2
CANgate User’s Manual
Page 26
GPSSEND – Send Commands to GPS
GPSSEND "
text
"
where
text
is a text string to send to the GPS port. Escape sequences eg
\n
,
\009
will be translated into the appropriate
control characters.
Some GPS devices can be configured – for example to switch certain NMEA-0183 strings on or off – by sending commands
to them via their serial interface. The
GPSSEND
command allows you to send arbitrary command strings to the GPS. If the
GPS requires that commands be terminated by a CRLF then include
\n
at the end of the string.
Examples
GPSSEND "$PGRMO,GPVTG,0\n"
This command will configure a Garmin GPS unit to not output the GPVTG sentence type.
STATUS – List Memory Slot Status
STATUS
This command returns a summary of all defined memory slots. The information returned includes:
memory slot number (
0-150
)
type of memory slot (
RECV
,
RQST
, etc.)
port number (
CAN1
or
CAN2
)
CAN identifier and 8-byte data field to use in transmitted message (SEND, SENDE, RQST, RQSTJ only)
CAN identifier to look for in received message (RECV, RECVE, RECVJ, RQST, RQSTJ only)
GPS header and field number to look for (GPS only)
Start and end byte/bit number of field of interest (RECV, RECVE, RECVJ, RQST, RQSTJ only)
Internal status information ("flags")
sample
period
This command can be useful for verifying that all required memory slots have been created successfully. Recall that in
non-verbose mode no error messages will be issued if an invalid slot definition is entered.
Example
STATUS
****** CHANNEL TABLE ******
0: RQST (CAN1) - TxID:0x07df TxData:041800ff 00000000 RxID:0x07df
RxBytes:2.8-end Flags:c0820000 Sample:0 ms
1: RECV (CAN1) - RxID:0x0001 RxBytes:1.8-1.1 Flags:c0020000 Sample:0 ms
2: RECV (CAN1) - RxID:0x0002 RxBytes:1.8-1.1 Flags:c0020000 Sample:0 ms
3: RECV (CAN1) - RxID:0x0003 RxBytes:1.8-1.1 Flags:c0020000 Sample:0 ms
6: RECVE (CAN1) - RxID:0x0006 RxBytes:1.8-1.1 Flags:c0220000 Sample:0 ms
7: RECVE (CAN1) - RxID:0x0007 RxBytes:1.8-1.1 Flags:c0220000 Sample:0 ms
***************************
STATS – Display Communications Statistics
STATS
{
CLEAR
}
This diagnostic command displays communications statistics for each port (host, GPS, CAN1, CAN2). These include:
volume of traffic sent (
Tx
) and received (
Rx
), measured in bytes for the serial ports, and in frames for the CAN ports
number of transmit bytes/frames that could not be sent (
Dropped Tx
). This may occur if the slot sample rates are set
too fast, so that the volume of traffic required to be sent exceeds the available bandwidth on the port.
number of bytes/frames that could not be received and/or processed (
Dropped Rx
). This may occur if the slot
sample rates are set such that CANgate cannot keep up with the rate of incoming messages.
number of bytes/frames which were discarded due to errors. These may be due to electrical noise or incorrect bit rate
settings. Note that for CAN ports, "arbitration lost" (
ArbLost
) errors are a normal part of operation and simply
indicate that a CANgate transmission was delayed by a higher-priority message.
number of CANgate system errors, including RQST/RQSTJ queue overflows and processing overflows (occasions
when the configured slot sample rates could not be met due to excessive processing load)
an indication as to whether an exception (serious CANgate error that required a firmware restart) has occurred.
If the
CLEAR
parameter is specified then all statistics values are reset.
