# C Config APIs

**Detailed Description**

This section contains C Config APIs related to Cellular-V2X operation. These APIs are provided as an abstraction of the CV2X configuration relevant interfaces.

- *group* Telematics\_cv2x\_c\_config

    - Abstraction of the CV2X configuration relevant interfaces.

Typedefs

- typedef void (\*cv2x\_config\_event\_listener)(v2x\_config\_event\_info\_t info)

    - Callback made when the v2x config file changes.

- **Associated data types**
    - v2x\_config\_event\_info\_t

- Param config:

    - **[in]** V2X config file information.

Enums

- enum v2x\_config\_soure\_t

    - V2X configuration source types listed in ascending order of priority. The system always uses the V2X configuration with the highest priority if multiple V2X configuration sources exist.

*Values:*

- enumerator V2X\_CONFIG\_SOURCE\_UNKNOWN

    - V2X config file source is unknown

- enumerator V2X\_CONFIG\_SOURCE\_PRECONFIG

    - V2X config file source is preconfig

- enumerator V2X\_CONFIG\_SOURCE\_SIM\_CARD

    - V2X config file source is SIM card

- enumerator V2X\_CONFIG\_SOURCE\_OMA\_DM

    - V2X config file source is OMA-DM

- enum v2x\_config\_event\_t

    - Events relevant to CV2X config file.

*Values:*

- enumerator V2X\_CONFIG\_EVENT\_CHANGED

    - V2X config file is changed

- enumerator V2X\_CONFIG\_EVENT\_EXPIRED

    - V2X config file is expired

Functions

- v2x\_status\_enum\_type v2x\_register\_for\_config\_change\_ind(cv2x\_config\_event\_listener callback)

    - Register listener for any updates to CV2X configuration.

- **Associated data types**
    - cv2x\_config\_event\_listener

- **Detailed description**
    - This function should be called before calling v2x\_update\_configuration or v2x\_retrieve\_configuration if the caller has interest in the notification of V2X configuration events.

- 
    - V2X\_CONFIG\_EVENT\_CHANGED v2x\_config\_event\_t is sent to registered CV2X configuration listeners if the content of the active V2X configuration file is changed by calling v2x\_update\_configuration or the active V2X configuration file source v2x\_config\_soure\_t is changed from one type to another.

- 
    - V2X\_CONFIG\_EVENT\_EXPIRED v2x\_config\_event\_t is sent to registered CV2X configuration listeners when the active V2X configuration file is expired.

- 
    - V2X\_STATUS\_FAIL — If there is an error.

- Parameters:

    - **callback** – **[in]** Callback function of cv2x\_config\_event\_listener structure that is used during CV2X config events (such as CV2X configuration expriy or changed).

- Returns:

    - V2X\_STATUS\_SUCCESS.

- v2x\_status\_enum\_type v2x\_update\_configuration(const char \*config\_file\_path)

    - Updates the OMA-DM V2X radio configuration file.

On platforms with access control enabled, the caller needs to have TELUX\_CV2X\_CONFIG permission to successfully invoke this API.

- **Detailed description**
    - The V2X radio status must be INACTIVE. If the V2X status is ACTIVE or SUSPENDED (see v2x\_event\_t), call stop\_v2x\_mode() first.

- 
    - The functionality of V2X configuration expiration is supported by adding an expiration leaf to the V2X configuration file passed in. When the active configuration expires, the system fallbacks to a lower priority V2X configuration v2x\_config\_soure\_t if existed. If the V2X stauts is active, it changes to suspended when the active V2X configuration expires and then changes to active after the system fallbacks to a lower priority V2X configuration or changes to inactive if no V2X configuration is available.

- 
    - This call is a blocking call. When it returns the configuration has been updated, assuming no error.

- 
    - Otherwise:

- V2X\_STATUS\_EALREADY — Failure because V2X status is not V2X\_INACTIVE.
- V2X\_STATUS\_FAIL — Other failure.

- **Dependencies**
    - V2X radio status must be V2X\_INACTIVE (v2x\_event\_t).

- Parameters:

    - **config\_file\_path** – **[in]** Pointer to the path of the configuration file.

- Returns:

    - V2X\_STATUS\_SUCCESS.

- v2x\_status\_enum\_type v2x\_retrieve\_configuration(const char \*config\_file\_path)

    - Retrieve the V2X radio configuration file.

On platforms with access control enabled, the caller needs to have TELUX\_CV2X\_CONFIG permission to successfully invoke this API.

- 
    - This call is a blocking call. When it returns the configuration has been read out, assuming no error.

- 
    - Otherwise:

- V2X\_STATUS\_FAIL — Other failure.

- Parameters:

    - **config\_file\_path** – **[in]** Pointer to the path of the configuration file.

- Returns:

    - V2X\_STATUS\_SUCCESS.

- struct v2x\_config\_event\_info\_t

    - Information about any update to a V2X config file.

Public Members

- v2x\_config\_soure\_t source

    - The type of the V2X config file.

- v2x\_config\_event\_t event

    - Config file event.

Last Published: Apr 14, 2026

Previous Topic
 
C Vehicle APIs Next Topic

C Packet APIs