www.beck-ipc.com

GMLib - GPS


GPS

Functions for GPS support

  • gmSetGPSAntennaMode
  • gmGetGPSLocation


  • int gmSetGPSAntennaMode(int mode, int voltage)

    This function sets the GPS antenna power supply mode and voltage value at the GM02 module. The GM01/GM03/GM04 module does not implement this command and will always return GM_EXIT_FAILURE.

    Parameters

    mode

    GPS Antenna Mode:
        0 - Power Off
        1 - Power On

    voltage

    GPS Antenna Voltage:
        see gmGpsVoltage

    Return Value

    Return values are described here: Return values


    Top
    Index page


    int gmGetGPSLocation(long timeout, int * day, int * month, int * year, int * hours, int * minutes, int * seconds, char * positionStr, int * altitude, int * velocityStr, int * heading, int * satInfo, char * dopStr, int * fixType)

    This function gets the current GPS location data at the GM02 module. The GM01/GM03/GM04 module does not implement this command and will always return GM_EXIT_FAILURE.

    Parameters

    timeout

    Input parameter: Timeout to wait for GPS data in ms.

    day

    Output parameter: Date: Day

    month

    Output parameter: Date: Month

    year

    Output parameter: Date: Year

    hours

    Output parameter: Time: Hours

    minutes

    Output parameter: Time: Minutes

    seconds

    Output parameter: Time: Seconds

    positionStr

    Output parameter: Actual position (Latitude, Longitude).
    String buffer must have at least a size of 40 characters.

    altitude

    Output parameter: Actual altitude

    velocityStr

    Output parameter: Actual velocity (in 0.25 m/s)
    String buffer must have at least a size of 10 characters.

    heading

    Output parameter: Actual heading (0..3599)

    satInfo

    Output parameter: Number of visible satellites 0..12

    dopStr

    Output parameter: Receiver status: Position DOP - poor quality (DOP>8)
    String buffer must have at least a size of 10 characters.

    fixType

    Output parameter: Receiver status: Fix Type: 0 - No Fix, 1 - 2D Fix, 2 - 3D Fix

    Return Value

    Return values are described here: Return values


    Top
    Index page


    End of document