Difference between revisions of "Component: GPS (EB056, Generic NMEA) (Wireless)"

From Flowcode Help
Jump to navigationJump to search
Line 20: Line 20:
  
 
==Detailed description==
 
==Detailed description==
 +
 +
  
  
Line 36: Line 38:
  
 
==Examples==
 
==Examples==
 +
 +
  
  
Line 66: Line 70:
 
{{Fcfile|GPSTracker.fcfx|GPS Tracker}}
 
{{Fcfile|GPSTracker.fcfx|GPS Tracker}}
  
==Downloadable macro reference==
+
==Macro reference==
  
 
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"

Revision as of 14:11, 20 January 2023

Author Matrix Ltd.
Version 2.1
Category Wireless


GPS (EB056, Generic NMEA) component

Component designed to process incoming NMEA style GPS data and convert into meaningful values such as longitude, lattitude, ground speed, UTC date and time. Also available in the form of the EB056 GPS E-block.

Component Source Code

Please click here for the component source code: FC_Comp_Source_GPS.fcfx

Detailed description

No detailed description exists yet for this component

Examples

GPS Example File FC6 Icon.png GPS Example Example should show the Latitude generated by the GPS injector as well as the system time in simulation or UTC time on hardware.

GPS.jpg


Example data provided by the GPS NMEA injector component

GPSCon.jpg


GPS tracking application using an Arduino and an SD card reader. FC6 Icon.png GPS Tracker

Macro reference

Fc9-comp-macro.png ReadGroundSpeed
Returns the current ground speed. Only returns correct data if Log Ground Speed property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadNumberOfSatellites
Returns the current detected number of satellites. Only returns correct data if Log Satellite Count property is set to yes. 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadDilutionOfPrecision
Returns the current dilution of precision. Only returns correct data if Log Dilution Of Precision property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png CheckBufferOverflow
Returns the state of the buffer - 0 = OK, 1 = BufferTooShort, 2 = ItemNotFound. Only returns correct data if Log Buffer Overflow Property is set to Yes. 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadLongitude
Returns the current longitude. Only returns correct data if Log Longitude property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadUTCTime
Returns a segment of the current UTC Time. Only returns correct data if Log UTC Time property is set to yes. 
Fc9-u8-icon.png - BYTE Unit
Specifies which segment to read - 'h', 'm', 's' 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png IsDataValid
Returns the state of the incoming data - 0 = NotValid, 1 = Valid 255 = No GPS Data Received. 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadHorizontalDilutionOfPrecision
Returns the current horizontal dilution of precision. Only returns correct data if Log HDOP property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadAltitude
Returns the current altitude. Only returns correct data if Log Altitude property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadCourseOverGround
Returns the current course over ground. Only returns correct data if Log Course Over Ground property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadUTCDate
Returns a segment of the current UTC Date. Only returns correct data if Log UTC Date property is set to yes. 
Fc9-u8-icon.png - BYTE Unit
Specifies which segment to read - 'd', 'm', 'y' 
Fc9-u8-icon.png - BYTE Return


Fc9-comp-macro.png ReadVerticalDilutionOfPrecision
Returns the current vertical dilution of precision. Only returns correct data if Log VDOP property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png ReadLatitude
Returns the current latitude. Only returns correct data if Log Latitude property is set to yes. 
Fc9-f32-icon.png - FLOAT Return


Fc9-comp-macro.png Initialise
Initialises the UART used to communicate with the GPS module. 
Fc9-void-icon.png - VOID Return



Property reference

Fc9-prop-icon.png Properties
Fc9-type-21-icon.png Buffer Size
The maximum number of bytes of a NMEA message we can store before processing the message. 
Fc9-type-7-icon.png Log Altitude
Adds a variable to store the incoming altitude value Referenced by macro: ReadAltitude 
Fc9-type-7-icon.png Log Buffer Overflow
Adds a variable to store if the incoming message buffer overflows Referenced by macro: CheckBufferOverflow 
Fc9-type-7-icon.png Log Course Over Ground
Adds a variable to store the incoming course over ground value Referenced by macro: ReadCourseOverGround 
Fc9-type-7-icon.png Log Dilution Of Precision
Adds a variable to store the incoming DOP value Referenced by macro: ReadDilutionOfPrecision 
Fc9-type-7-icon.png Log Ground Speed
Adds a variable to store the incoming ground speed value Referenced by macro: ReadGroundSpeed 
Fc9-type-7-icon.png Log Horizontal DOP
Adds a variable to store the incoming HDOP value Referenced by macro: ReadHorizontalDilutionOfPrecision 
Fc9-type-7-icon.png Log Latitude
Adds a variable to store the incoming latitude value Referenced by macro: ReadLatitude 
Fc9-type-7-icon.png Log Longitude
Adds a variable to store the incoming longitude value Referenced by macro: Read Longitude 
Fc9-type-7-icon.png Log Satellite Count
Adds a variable to store the number of satellites in range Referenced by macro: ReadNumberOfSatellites 
Fc9-type-7-icon.png Log UTC Time
Adds a variable to store the incoming UTC Time value Referenced by macro: ReadUTCTime 
Fc9-type-7-icon.png Log UTC Date
Adds a variable to store the incoming UTC Date value Referenced by macro: ReadUTCDate 
Fc9-type-7-icon.png Log Verticle DOP
Adds a variable to store the incoming VDOP value Referenced by macro: ReadVerticalDilutionOfPrecision 
Fc9-conn-icon.png Connections
Fc9-type-16-icon.png Channel
UART Channel selector Software channels are bit banged using generic I/O pins but are not as reliable as hardware channels. Hardware channels use the selected peripheral on-board the target microcontroller. 
Fc9-type-5-icon.png RX
Pin to be used for Receive data 
Fc9-type-16-icon.png Baud Options
Baud rate option selector 
Fc9-type-14-icon.png Baud Rate
 
Fc9-conn-icon.png Simulation
Fc9-type-10-icon.png Label
Label used to help identify the component on the panel. 
Fc9-type-7-icon.png Show Globe
Allows a graphical globe to be shown on the panel along with a coordinate marker. 
Fc9-type-7-icon.png Scope Traces
Selects if the scope traces are automatically added to the data recorder window or not. Simulation - draws an approximation of the UART data onto the scope trace. ICT - sets up the scope trace for incoming data and adds UART packet decoding at the correct BAUD. 
Fc9-type-7-icon.png Console Data
Selects if the console data is automatically generated or not 
Fc9-type-21-icon.png Console Columns
Number of characters that can be displayed on a single line of the console. 
Fc9-type-16-icon.png Data Source
Simulation data source used to allow the component to connect to various remote devices Nothing - Simulation data is ignored COM port - Routes the communication data to and from a physical or virtual COM port Injector - Routes the communication data via a data injector component on the Panel.