◆ ntn_evt_type

#include <include/modem/ntn.h>

NTN event types.

Enumerator

NTN_EVT_LOCATION_REQUEST

Modem location update request.

This event indicates whether the modem needs location updates. Modem needs to know the current location when NTN is used. When location updates are requested, the ntn_location_set() function must be called to set the current location to the modem. The event contains the accuracy requested by the modem. When the event is received with ntn_location_request.requested set to true, the ntn_location_set() function should be called as soon as possible even if location has been already set to the modem, because the modem may have requested location with better accuracy.

The required interval for calling the function depends on the requested accuracy and speed of the device. The accuracy of the location should remain within the requested accuracy at all times. If the device can move at a maximum of 120 km/h (33.3 m/s), the location should be updated at least every six seconds. It's the responsibility of the application to maintain the location with good enough accuracy at all times. If the modem does not have the current location with sufficient accuracy, NTN usage is not possible.

The associated payload is the ntn_evt.location_request member of type ntn_location_request in the event.