|
Linux SDK (lite-qmi)
MBPL_SDK_R25_ENG3
|
#include <loc.h>
Data Fields | |
| uint32_t | transactionId |
| uint32_t * | pGnssUnavailableIndicationTimeout |
| uint32_t * | pMaxGeofences |
| uint32_t * | pEnableMotionDetectionSources |
| uint8_t * | pEnableCpiUsage |
| uint32_t * | pGnssPositionSessionTimeout |
| uint32_t * | pGnssPositionMaxPuncAcceptable |
| uint32_t * | pMediumResponsivenessValue |
| uint32_t * | pChalGnssEnvMinCpiWaitInterval |
| GeofenceMotionInfo_t * | pGeofenceMotionStateInfo |
Qmi Loc Set Geofence Engin Config Req
\param transactionId
- Identifies the transaction. The QMI_LOC_DELETE_GEOFENCE_IND indication returns the transaction ID.
\param pGnssUnavailableIndicationTimeout;
- In a bad GNSS environment, this is the timeout after which the Geofence engine sends out a GNSS Unavailable indication.
- The GNSS Unavailable indication is sent under the following conditions:
- If gnssUnavailableIndicationTimeout is less than gnssPositionSessionTimeout, the GNSS Unavailable timeout indication is sent after gnssPositionSessionTimeout expires
- If gnssPositionSessionTimeout is less than gnssUnavailableIndicationTimeout, the GNSS Unavailable timeout indication is sent after gnssUnavailableIndicationTimeout expires Type
\param pMaxGeofences
- Max Geofences Length Value
- Identifies the maximum number of Geofences that the Geofence enginer can support. If this number is less than the currently deployed Geofences, this command fails.
- If the command succeeds, the engine supports the maximum number of Geofences requested, provided there is enough memory to support that many Geofences.
- Increasing this value to a very large number in a constrained memory environment might affect other modules negatively.
- This value is determined by phone manufacturers. The default value is 200.
\param pEnableMotionDetectionSources
- Enable Motion Detection Sources
- Identifies the sources that the Geofence engine can enable for motion detection.
- The sources of motion detection that the Geofence enginer enable are dependent on the platform. These sources are only set once at boot time, they are not
- expected to change after that. Any attempt to set the value of the motion detection sources at runtime results in an undefined behavior.
- Valid values:
- QMI_LOC_MOTION_DETECTION_SOURCE_SENSORS (0x00000001) - Sensors are used for motion detection
- QMI_LOC_MOTION_DETECTION_SOURCE_WIFI (0x00000002) - Wi-Fi is used for motion detection
- QMI_LOC_MOTION_DETECTION_SOURCE_WWAN (0x00000004) - Wireless WAN is used for motion detection
\param pEnableCpiUsage
- Enable Coarse Position Injection Usage
- Indicates whether the Geofence engine uses external Coarse Position Injection (CPI).
- 0x01 (TRUE) - CPI is enabled (default)
- 0x00 (FALSE) - CPI is disabled
\param pGnssPositionSessionTimeout
- GNSS Position QOS Session Timeout
-Identifies the session timeout value (in seconds) for requesting a position in a bad GNSS environment.
- Valid values:
- If the gnssUnavailableIndicationTimeout value is less than gnssPositionSessionTimeout, in a bad GNSS environment,
- the GNSS Unavailable timeout indication is sent after gnssPositionSessionTimeout expires.
- If gnssPositionSessionTimeout is less than gnssUnavailableIndicationTimeout, in a bad GNSS environment,
- the GNSS Unavailable timeout indication is sent after gnssUnavailableIndicationTimeout expires.
\param pGnssPositionMaxPuncAcceptable
- GNSS Position Maximum Position Uncertainity Acceptable
- GNSS maximum position uncertainity in meters acceptable by the Geofence engine.
- Valid values:
- All positive values
\param pMediumResponsivenessValue
- Medium Responsiveness Value
- Medium responsiveness value in seconds that the Geofence engine uses for all medium responsiveness Geofences in the Geofence engine.
- Valid values:
- Positive values (in seconds)
- If the value is configured for less than 30 seconds, the value is set at 30 seconds
- If the value is configured for more than 600 seconds, the value is set at 600 seconds
- Default - The Geofence engine uses 120 seconds as the medium responsiveness value If the medium responsiveness value is changed,
- the responsiveness of the existing medium responsiveness Geofence does not change until the next position fix,
- which is based on the previous medium responsiveness setting.
\param pChalGnssEnvMinCpiWaitInterval
- Challenging GNSS Environment Minimum CPI Wait Interval
- Number of seconds that the Geofence engine is to wait between CPI requests in challenging a GNSS environment.
- Valid values:
- Positive values (in seconds)
\param pGeofenceMotionStateInfo
- Geofence Motion State Information Motion state information (for example, motion state speed) that the Geofence engine is to use.