# C Vehicle APIs **Detailed Description** This section contains C Vehicle APIs related to Cellular-V2X operation. These APIs are provided as reference APIs to work with QTI reference hardware. Customers would need to modify the implementation of these APIs based on the specific H/W and CAN controller being used. - *group* Telematics\_cv2x\_c\_vehicle - Abstraction of the vehicle system parameters required for CAM/BSM ITS beacons. Defines - V2X\_VDATA\_HANDLE\_BAD - Invalid handle returned when there is an error. - V2X\_J2735\_TRACTION\_CONTROL\_MAX - Guard check value on [v2x\_transmission\_state\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1gad7afc11ed8bf497860bb0a3460506dda.html#a00021_1gad7afc11ed8bf497860bb0a3460506dda) for [V2X\_TRANSMISSION\_MAX](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1gad7afc11ed8bf497860bb0a3460506dda.html#a00021_1ggad7afc11ed8bf497860bb0a3460506ddaa04cbffadd73446c4f6c4b031b04595e0). This value is used in a 3-bit bitfield in J2735. - V2X\_TRACTION\_CTRL\_MAX - Guard check value on [v2x\_TractionControlStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1gab23af0c4c2012522183a2a7bc928659b.html#a00021_1gab23af0c4c2012522183a2a7bc928659b) for [V2X\_TRACTION\_CTRL\_MAX](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00021_1gac84538cc45d10ce29a1f07321a8adbb0). This value is used in a 2-bit bitfield in J2735. - J2735\_ABS\_MAX - Guard check value on [v2x\_AntiLockBrakeStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1ga6fb81079b1593e994be852d814a9a340.html#a00021_1ga6fb81079b1593e994be852d814a9a340). This value cannot be part of the enumeration because the value eventually ends up in 2-bit bitfield over the air. - V2X\_STABILITY\_CONTROL\_MAX - Guard check value on [v2x\_StabilityControlStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1gadaf4138e128435bff449d40eee5ded79.html#a00021_1gadaf4138e128435bff449d40eee5ded79). This value is eventually used over the air in a 2-bit bitfield. The enumeration value must never be larger than 4. - V2X\_AUX\_BRAKE\_MAX - Guard check value on [v2x\_AuxBrakeStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00021_1ga4e91848cabeaf7091d58fabfc661a689.html#a00021_1ga4e91848cabeaf7091d58fabfc661a689). This value must never be set this high. Typedefs - typedef int v2x\_vehicle\_handle\_t - Vehicle data handle to the interface - typedef int v2x\_motion\_data\_handle\_t - Vehicle high-resolution motion handle to the interface - typedef void (\*v2x\_high\_res\_motion\_listener\_t)([high\_resolution\_motion\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv424high_resolution_motion_t) \*motion\_data) - Callback used for high resolution motion data. - **Associated data types** - [high\_resolution\_motion\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00363.html#a00363) - Param motion\_data: - **[in]** Pointer to the dynamic state of the vehicle. - typedef void (\*v2x\_vehicle\_event\_listener\_t)([current\_dynamic\_vehicle\_state\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv431current_dynamic_vehicle_state_t) \*current\_state, void \*context) - Callback used for critical event notification and other less critical events. - **Associated data types** - [current\_dynamic\_vehicle\_state\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00364.html#a00364) - Param current\_state: - **[in]** Pointer to the dynamic state of the vehicle. - Param context: - **[in]** Pointer to the application context used with the callbacks to help the caller code. Enums - enum v2x\_transmission\_state\_enum\_type - Valid types for main transmission drive states. *Values:* - enumerator V2X\_TRANSMISSION\_NEUTRAL - - enumerator V2X\_TRANSMISSION\_PARK - - enumerator V2X\_TRANSMISSION\_FORWARD\_GEARS - One of the gears: D, 1, 2, 3, … . - enumerator V2X\_TRANSMISSION\_REVERSE\_GEARS - - enumerator V2X\_TRANSMISSION\_RESERVED1 - - enumerator V2X\_TRANSMISSION\_RESERVED2 - - enumerator V2X\_TRANSMISSION\_RESERVED3 - - enumerator V2X\_TRANSMISSION\_UNAVAILABLE - Status is unknown. - enumerator V2X\_TRANSMISSION\_MAX - Sentry variable that must not be exceeded. - enum v2x\_BrakeBoostApplied\_enum\_type - Valid types for brake boosting states. *Values:* - enumerator V2X\_BRAKEBOOST\_UNAVAIL - Status is unknown. - enumerator V2X\_BRAKEBOOST\_OFF - - enumerator V2X\_BRAKEBOOST\_ON - - enumerator V2X\_BRAKEBOOST\_MAX - Sentry variable that must not be exceeded. - enum v2x\_TractionControlStatus\_enum\_type - Valid types for traction control states. This enumeration currently matches the J2735 2016 version for the Traction Control System (TCS). *Values:* - enumerator V2X\_TRACTION\_CTRL\_UNAVAIL - Status is unknown. - enumerator V2X\_TRACTION\_CTRL\_OFF - - enumerator V2X\_TRACTION\_CTRL\_ON - On but currently not engaged. - enumerator V2X\_TRACTION\_CTRL\_ENGAGED - Actively being engaged. - enum v2x\_AntiLockBrakeStatus\_enum\_type - Valid types for antilock-braking states. This enumeration matches the J2735 2016 version for the Antilock Braking System (ABS) to help BSM packing and unpacking. *Values:* - enumerator V2X\_ABS\_Unavailable - ABS is not equipped, or the status is unknown. - enumerator V2X\_ABS\_Off - - enumerator V2X\_ABS\_On - On but currently not active. - enumerator V2X\_ABS\_Engaged - Actively being engaged on one or more wheels. - enum v2x\_StabilityControlStatus\_enum\_type - Valid types for the stability control status. This enumeration should be equivalent to the J2735 BSM version you are working with. *Values:* - enumerator V2X\_STABILITY\_CONTROL\_UNAVAILBLE - Stability Control status is unknown. - enumerator V2X\_STABILITY\_CONTROL\_OFF - Stability Control is not applied. - enumerator V2X\_STABILITY\_CONTROL\_ON - Stability Control is on, but currently it is not engaged. - enumerator V2X\_STABILITY\_CONTROL\_ENGAGED - Stability Control is actively being engaged. - enum v2x\_AuxBrakeStatus\_enum\_type - Valid types for the auxiliary brake status. This enumeration should match the J2735 2016 version or any other version you are working with. *Values:* - enumerator V2X\_AUX\_BRAKE\_UNAVAILBLE - Vehicle has no auxiliary brake equipment or the status is unknown. - enumerator V2X\_AUX\_BRAKE\_OFF - - enumerator V2X\_AUX\_BRAKE\_ON - - enumerator V2X\_AUX\_BRAKE\_RESERVED - Functions - [v2x\_api\_ver\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/c_apis_common.html#_CPPv413v2x_api_ver_t) v2x\_vehicle\_api\_version(void) - Gets the compiled API version interface (as an integer number). - Returns: - [v2x\_api\_ver\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00329.html#a00329) — Filled with the version number, build date, and detailed build information. - [v2x\_status\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/c_apis_common.html#_CPPv420v2x_status_enum_type) v2x\_vehicle\_get\_static\_params([static\_vehicle\_parameters\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv427static_vehicle_parameters_t) \*parameters) - Returns (via a reference pointer) the [static\_vehicle\_parameters\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00365.html#a00365) structure that enumerates static (unchanging) data items used by ITS stacks. - **Associated data types** - [static\_vehicle\_parameters\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00365.html#a00365) - **Detailed description** - This call is a nonblocking call. If the values are not yet available from the vehicle, the data element is 0 (NULL). - - Because this function is sometimes populated with data from an in-vehicle network, it might be incomplete and only partially populated early in a system start-up. However, all values can be statically compiled in or loaded from an initialization file. In this case, the data is fully provided on the first call. - - Error code — If there is a problem (see [v2x\_status\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00064_1ga49d62bdeb1801fa5715ad5fe72f9427d.html#a00064_1ga49d62bdeb1801fa5715ad5fe72f9427d)). - Parameters: - **parameters** – **[out]** Pointer to the static vehicle parameters, including vehicle dimensions, make, model, and so on. - Returns: - [V2X\_STATUS\_SUCCESS](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00064_1ga49d62bdeb1801fa5715ad5fe72f9427d.html#a00064_1gga49d62bdeb1801fa5715ad5fe72f9427dad6de32b5dffe2d50d735121355f2cfc6) — This function is successfully populated with the results. - [v2x\_motion\_data\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gac868ec9a9ab78c6d53eb647da8b1102d.html#_CPPv424v2x_motion_data_handle_t) v2x\_high\_res\_motion\_register\_listener([v2x\_high\_res\_motion\_listener\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gac2803eda3d6ce52c940d9d0e0e9188c5.html#_CPPv430v2x_high_res_motion_listener_t) cb) - Registers for high-resolution motion callbacks from the vehicle data network (CAN bus) when the data changes. - **Associated data types** - [v2x\_high\_res\_motion\_listener\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00021_1gac2803eda3d6ce52c940d9d0e0e9188c5) - - -1 — If there is an error in registering a callback. - Parameters: - **cb** – **[in]** Callback function to use for this listener. - Returns: - Handle number to use with subsequent deregister calls. - [v2x\_status\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/c_apis_common.html#_CPPv420v2x_status_enum_type) v2x\_high\_res\_motion\_deregister\_listener([v2x\_motion\_data\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gac868ec9a9ab78c6d53eb647da8b1102d.html#_CPPv424v2x_motion_data_handle_t) handle) - Deregisters a previously registered high-resolution motion data callback that was requested via [v2x\_high\_res\_motion\_register\_listener()](https://docs.qualcomm.com/doc/80-PF458-8/topic/function_a00021_1ga90d868baaaed0c2c8b57874fa716d424.html#a00021_1ga90d868baaaed0c2c8b57874fa716d424). - **Associated data types** - [v2x\_motion\_data\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00021_1gac868ec9a9ab78c6d53eb647da8b1102d) - **Dependencies** - The callback must have been previously registered with [v2x\_high\_res\_motion\_register\_listener()](https://docs.qualcomm.com/doc/80-PF458-8/topic/function_a00021_1ga90d868baaaed0c2c8b57874fa716d424.html#a00021_1ga90d868baaaed0c2c8b57874fa716d424). - Parameters: - **handle** – **[in]** Handle of the listener callback previously set up. - Returns: - [V2X\_STATUS\_SUCCESS](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00064_1ga49d62bdeb1801fa5715ad5fe72f9427d.html#a00064_1gga49d62bdeb1801fa5715ad5fe72f9427dad6de32b5dffe2d50d735121355f2cfc6). - [v2x\_vehicle\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gaaa4993e43347a0b0c48bf356e6262c24.html#_CPPv420v2x_vehicle_handle_t) v2x\_vehicle\_register\_listener([v2x\_vehicle\_event\_listener\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gabc2361609de11efb59e230b4b3a35267.html#_CPPv428v2x_vehicle_event_listener_t) cb, void \*context) - Registers for a callback for state updates from the vehicle data network (CAN bus). This function requests vehicle data callbacks when data changes or events occur. - **Associated data types** - [v2x\_vehicle\_event\_listener\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00021_1gabc2361609de11efb59e230b4b3a35267) - - -1 — If there is an error in registering a callback. - Parameters: - - **cb** – **[in]** Callback function to use for this listener. - **context** – **[in]** Pointer to the application context for use with the callbacks, which can help the caller code. - Returns: - Handle number to use with subsequent deregister calls. - [v2x\_status\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/c_apis_common.html#_CPPv420v2x_status_enum_type) v2x\_vehicle\_deregister\_for\_callback([v2x\_vehicle\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/typedef_a00021_1gaaa4993e43347a0b0c48bf356e6262c24.html#_CPPv420v2x_vehicle_handle_t) handle) - Deregisters a previously registered dynamic event callback that was requested via [v2x\_vehicle\_register\_listener()](https://docs.qualcomm.com/doc/80-PF458-8/topic/function_a00021_1ga495f5c762780f572ecf5a79bc4c6a2c4.html#a00021_1ga495f5c762780f572ecf5a79bc4c6a2c4). - **Associated data types** - [v2x\_vehicle\_handle\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00021_1gaaa4993e43347a0b0c48bf356e6262c24) - **Dependencies** - The callback must have been previously registered. - Parameters: - **handle** – **[in]** Handle of the listener callback previously set up. - Returns: - [V2X\_STATUS\_SUCCESS](https://docs.qualcomm.com/doc/80-PF458-8/topic/enum_a00064_1ga49d62bdeb1801fa5715ad5fe72f9427d.html#a00064_1gga49d62bdeb1801fa5715ad5fe72f9427dad6de32b5dffe2d50d735121355f2cfc6) — If the callback is successfully deregistered. - union v2x\_control\_status\_ut - Contains information related to ABS, TCS, stability control state, and other vehicle output controls that might occur and be ongoing. This structure mirrors the J2735 bit frames. Public Members - struct [v2x\_control\_status\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00360.html#_CPPv421v2x_control_status_ut)::[anonymous] bits - Bit values for control status information. - unsigned short word - Byte data access to the packed v2x\_control\_status union structure. - v2x\_control\_status\_ut.bits - Bit values for control status information. Public Members - unsigned unused\_padding - Reserved for 16-bit alignment. This field is critical because of 16-bit word access to the packed [v2x\_control\_status\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#a00360) union structure. - [v2x\_AuxBrakeStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv428v2x_AuxBrakeStatus_enum_type) aux\_brake\_status - Indicates whether the auxiliary braking system is on. - 0 - Off - 1 - On - [v2x\_BrakeBoostApplied\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv431v2x_BrakeBoostApplied_enum_type) brake\_boost\_applied - Indicates whether the brakes are actively being boosted. - 0 - Not boosted - 1 - Boosted - [v2x\_StabilityControlStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv436v2x_StabilityControlStatus_enum_type) stability\_control\_status - Indicates whether stability control is on and engaged. - 0 - Off - 1 - On - [v2x\_AntiLockBrakeStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv433v2x_AntiLockBrakeStatus_enum_type) antilock\_brake\_status - Indicates the status of the ABS. - [v2x\_TractionControlStatus\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv435v2x_TractionControlStatus_enum_type) traction\_control\_status - Indicates whether status of the TCS. - unsigned rightRear - Indicates whether the right rear brakes are actively being applied. - 0 - Not applied - 1 - Applied - unsigned rightFront - Indicates whether the right front brakes are actively being applied. - 0 - Not applied - 1 - Applied - unsigned leftRear - Indicates whether the left rear brakes are actively being applied - 0 - Not applied - 1 - Applied - unsigned leftFront - Indicates whether the front left brakes are actively being applied. - 0 - Not applied - 1 - Applied - unsigned unavailable - No information is available. - union vehicleEventFlags\_ut - Contains critical events and communication of ongoing events. Also is used for combinations of critical and not critical (wipers) events This typedef can match the J2735 2016 version or another version you are working with. Public Members - struct [vehicleEventFlags\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00361.html#_CPPv420vehicleEventFlags_ut)::[anonymous] bits - Bit values for vehicle event flags. - unsigned short data - Sixteen-bit word access to the packed vehicleEventFlags union structure. - vehicleEventFlags\_ut.bits - Bit values for vehicle event flags. A flag indicates the state of the event. Public Members - unsigned unused - Reserved for 16-bit alignment in the union access. - unsigned eventAirBagDeployment - Indicates whether the airbag is deployed. - 0 - Not deployed - 1 - Deployed - unsigned eventDisabledVehicle - Indicates whether the vehicle is disabled. - 0 - Not disabled - 1 - Disabled - unsigned eventFlatTire - Indicates whether the tire is flat. - 0 - Not flat - 1 - Flat - unsigned eventWipersChanged - Indicates the status of the windshield wipers. For more information, See the wiper state variables in [current\_dynamic\_vehicle\_state\_t](https://docs.qualcomm.com/doc/80-PF458-8/topic/struct_a00364.html#a00364). - unsigned eventLightsChanged - Indicates the status of one or more lights (such as blinkers and fog). - unsigned eventHardBraking - Indicates whether hard braking is activated. - 0 - Not activated - 1 - Activated - unsigned eventReserved1 - Event bit reserved for future use. Do not use. - unsigned eventHazardousMaterials - Indicates whether a hazmat load is present. - 0 - Not present - 1 - Present - unsigned eventStabilityControlactivated - Indicates whether stability control is on. - 0 - Off - 1 - On - unsigned eventTractionControlLoss - Indicates whether traction control is activated (1) or not (0). - 0 - Not applied - 1 - Applied - unsigned eventABSactivated - Indicates whether ABS is activated. - 0 - Not activated - 1 - Activated - unsigned eventStopLineViolation - Indicates whether the vehicle has detected that a violation of the Stop Line is imminent. - 0 - Not imminent - 1 - Imminent - unsigned eventHazardLights - Indicates whether the hazard lights are on. - 0 - Off - 1 - On - union ExteriorLights\_ut - Contains information about the state of the exterior lights. Public Members - struct [ExteriorLights\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00362.html#_CPPv417ExteriorLights_ut)::[anonymous] bits - Bit values for exterior light flags. - unsigned short data - 16-bit short word access to the packed ExteriorLights union structure. - ExteriorLights\_ut.bits - Bit values for exterior light flags. Public Members - unsigned parkingLightsOn - Indicates whether the parking lights are on. - 0 - Off - 1 - On - unsigned fogLightOn - Indicates whether the fog lights are on. - 0 - Off - 1 - On - unsigned daytimeRunningLightsOn - Indicates whether the running lights are on. - 0 - Off - 1 - On - unsigned automaticLightControlOn - Indicates whether the automatic light control is on. - 0 - Off - 1 - On - unsigned hazardSignalOn - Indicates whether the hazard lights are on. - 0 - Off - 1 - On - unsigned rightTurnSignalOn - Indicates whether the right turn light is on. - 0 - Off - 1 - On - unsigned leftTurnSignalOn - Indicates whether the left turn light is on. - 0 - Off - 1 - On - unsigned highBeamHeadlightsOn - Indicates whether the high beam headlights are on. - 0 - Off - 1 - On - unsigned lowBeamHeadlightsOn - Indicates whether the low beam headlights are on. - 0 - Off - 1 - On - unsigned unused - Unused padding bits. - struct high\_resolution\_motion\_t - Contains high-resolution motion parameters. Public Members - double vehicle\_speed - Vehicle speed in meters/second. - double longitudinal\_acceleration - Acceleration in a longitudinal direction, in meters/second^2. - double yaw\_rate - Yaw rate in degrees/second, per SAE J2735. - struct current\_dynamic\_vehicle\_state\_t - Contains information about the dynamic state of the vehicle. Public Members - [v2x\_transmission\_state\_enum\_type](https://docs.qualcomm.com/doc/80-PF458-8/topic/vehicle.html#_CPPv432v2x_transmission_state_enum_type) prndl - Specifies the current state of the transmission gear: forward, reverse, and so on. - [vehicleEventFlags\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00361.html#_CPPv420vehicleEventFlags_ut) events - Flags all critical events and combinations of critical events. - double throttle\_position - Per the J2735 definition, indicates the throttle position from 0% to 100%. However, this value is in double precision between 0 and 1. - double throttle\_confidence - Per the J2735 definition, double precision degrees of confidence. - double steering\_wheel\_angle - Per the J2735 definition, double precision degrees of the wheel angle. -192.0 through 189.0 degrees, with positive being turned to the right - [v2x\_control\_status\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00360.html#_CPPv421v2x_control_status_ut) brake\_status - Indicates whether brakes or emergency brakes (ABS) are activated. - 0 - Not activated - 1 - Activated - [ExteriorLights\_ut](https://docs.qualcomm.com/doc/80-PF458-8/topic/union_a00362.html#_CPPv417ExteriorLights_ut) exterior\_lights - Conglomeration of bits that indicate the status of the exterior lights, such as blinkers. - unsigned char front\_wiper\_status - Status of the front windshield wipers. - unsigned char rear\_wiper\_status - Status of the rear windshield wipers. - struct static\_vehicle\_parameters\_t - Contains static vehicle parameters. Public Members - double vehicle\_height\_cm - Vehicle height in centimeters. This parameter is 0 if the value is not yet available from the vehicle network. - double vehicle\_width\_cm - Vehicle width in centimeters. This parameter is 0 if the value is not yet available from the vehicle network. - double vehicle\_length\_cm - Vehicle length in centimeters. This parameter is 0 if the value is not yet available from the vehicle network. - double front\_bumper\_height\_cm - Height of the front bumper, in centimeters. This parameter is 0 if the value is not yet available from the vehicle network. - double rear\_bumper\_height\_cm - Height of the rear bumper, in centimeters. This parameter is 0 if the value is not yet available from the vehicle network. - double vehicle\_mass\_kg - Mass of the vehicle, in kilograms. This parameter is 0 if the value is not yet available from the vehicle network. - double trailer\_weight\_kg - Weight of a trailer connected to the vehicle, in kilograms. This parameter is 0 if the value is not yet available from the vehicle network. - char \*make - Pointer to the NULL-terminated string with the vehicle manufacturer that this software build supports (such as Ford and GM). - char \*model - Pointer to the NULL-terminated string with the vehicle model name that this software build supports (such as Prius, Mustang, Rogue). - unsigned short begin\_model\_year - Beginning of the model years that this software build supports. - unsigned short end\_model\_year - End of model year that this software build supports. This year might be the same as begin\_model\_year. Last Published: May 20, 2026 [Previous Topic C Radio APIs](https://docs.qualcomm.com/bundle/publicresource/80-PF458-8/topics/radio.md) [Next Topic C Config APIs](https://docs.qualcomm.com/bundle/publicresource/80-PF458-8/topics/config.md)