> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asps Acm API

**Header:** `spf/api/asps/asps_acm_api.h`

## Structures

### `event_id_asps_sensor_register_request_t`

Payload of the EVENT\_ID\_ASPS\_SENSOR\_REGISTER\_REQUEST data structure.

**Members**

**see\_sensor\_iid** `uint32_t`

Unique identifier for the audio sensor instance in SEE framework.

**usecase\_id** `uint32_t`

Indicates the usecase which a given sensor instance is trying to register.

**payload\_size** `uint32_t`

Size of the "usecase\_id" specific payload if any.

**payload** `uint32_t`

Points to "usecase\_id" specific paylod if any.

### `param_id_asps_sensor_register_ack_t`

Payload of the PARAM\_ID\_ASPS\_SENSOR\_REGISTER\_ACK data structure.

**Members**

**see\_sensor\_iid** `uint32_t`

Sensor instance iid which was passed as part of the ASPS event.

**usecase\_id** `uint32_t`

Indicates the usecase which a given sensor instance is trying to register.

**payload\_size** `uint32_t`

Size of the usecase\_id specific ACK payload following this structure.

**payload** `uint32_t`

Points to "usecase\_id" specific paylod if any.

### `event_id_asps_sensor_deregister_request_t`

Payload of the EVENT\_ID\_ASPS\_SENSOR\_DEREGISTER\_REQUEST data structure.

**Members**

**see\_sensor\_iid** `uint32_t`

Unique identifier for the audio sensor instance in SEE framework.

**usecase\_id** `uint32_t`

Module event ID for which sensor instance wants to de-register from.

### `event_id_asps_get_supported_context_ids_t`

Payload of the EVENT\_ID\_ASPS\_GET\_SUPPORTED\_CONTEXT\_IDS data structure.

**Members**

**see\_sensor\_iid** `uint32_t`

Unique identifier for the audio sensor instance in SEE framework thats requesting for the list of supported context ids.

### `param_id_asps_supported_context_ids_t`

Payload of the PARAM\_ID\_ASPS\_SUPPORTED\_CONTEXT\_IDS data structure.

**Members**

**see\_sensor\_iid** `uint32_t`

Unique identifier for the audio sensor instance in SEE framework that requested for the list of supported context ids.

**num\_supported\_contexts** `uint32_t`

Number of supported context ids.

**supported\_context\_ids** `uint32_t`

Variable length array of supported context ids.

### `param_id_asps_basic_ack_t`

Payload of the PARAM\_ID\_ASPS\_BASIC\_ACK data structure.

**Members**

**error\_code** `uint32_t`

Audio reach error code.

**asps\_event\_id** `uint32_t`

ASPS event ID to which this response is being returned.

**see\_sensor\_iid** `uint32_t`

Sensor instance iid which was passed as part of the ASPS event.

**usecase\_id** `uint32_t`

Usecase ID for which the response is being returned.

## Type Definitions

### `event_id_asps_sensor_register_request_t`

```cpp theme={null}
typedef struct event_id_asps_sensor_register_request_t event_id_asps_sensor_register_request_t
```

### `param_id_asps_sensor_register_ack_t`

```cpp theme={null}
typedef struct param_id_asps_sensor_register_ack_t param_id_asps_sensor_register_ack_t
```

### `event_id_asps_sensor_deregister_request_t`

```cpp theme={null}
typedef struct event_id_asps_sensor_deregister_request_t event_id_asps_sensor_deregister_request_t
```

### `event_id_asps_get_supported_context_ids_t`

```cpp theme={null}
typedef struct event_id_asps_get_supported_context_ids_t event_id_asps_get_supported_context_ids_t
```

### `param_id_asps_supported_context_ids_t`

```cpp theme={null}
typedef struct param_id_asps_supported_context_ids_t param_id_asps_supported_context_ids_t
```

### `param_id_asps_basic_ack_t`

```cpp theme={null}
typedef struct param_id_asps_basic_ack_t param_id_asps_basic_ack_t
```

## Macros

### `ASPS_MODULE_INSTANCE_ID`

```c theme={null}
#define ASPS_MODULE_INSTANCE_ID 0x00000007
```

### `EVENT_ID_ASPS_SENSOR_REGISTER_REQUEST`

Event raised by ASPS to setup a given usecase for a given sensor instance.

```c theme={null}
#define EVENT_ID_ASPS_SENSOR_REGISTER_REQUEST 0x080012EB
```

### `PARAM_ID_ASPS_SENSOR_REGISTER_ACK`

This parameter is set as an ACK to the event EVENT\_ID\_ASPS\_SENSOR\_REGISTER\_REQUEST.

```c theme={null}
#define PARAM_ID_ASPS_SENSOR_REGISTER_ACK 0x080012ED
```

### `EVENT_ID_ASPS_SENSOR_DEREGISTER_REQUEST`

De-registers request event ID.

```c theme={null}
#define EVENT_ID_ASPS_SENSOR_DEREGISTER_REQUEST 0x080012EC
```

### `EVENT_ID_ASPS_GET_SUPPORTED_CONTEXT_IDS`

Event raised by ASPS to get list of supported instance IDS.

```c theme={null}
#define EVENT_ID_ASPS_GET_SUPPORTED_CONTEXT_IDS 0x08001302
```

### `PARAM_ID_ASPS_SUPPORTED_CONTEXT_IDS`

Set param to inform list of supported context ids to ASPS.

```c theme={null}
#define PARAM_ID_ASPS_SUPPORTED_CONTEXT_IDS 0x08001303
```

### `EVENT_ID_ASPS_CLOSE_ALL`

Event raised by ASPS to close all the sessions corresponding to earlier register requests.

```c theme={null}
#define EVENT_ID_ASPS_CLOSE_ALL 0x0800133E
```

### `PARAM_ID_ASPS_BASIC_ACK`

Sets the error code corresponding to the request event raised by ASPS.

```c theme={null}
#define PARAM_ID_ASPS_BASIC_ACK 0x08001304
```
