sound/soc/intel/atom/sst-atom-controls.h

File Facts

System

Linux kernel

Corpus path

sound/soc/intel/atom/sst-atom-controls.h

Extension

.h

Size

27051 bytes

Lines

876

Domain

Driver Families

Bucket

sound/soc

Inferred role

Driver Families: implementation source

Status

source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• sound/soc.h
• sound/tlv.h

Detected Declarations

• struct sst_destination_id
• struct sst_dsp_header
• struct sst_cmd_generic
• struct swm_input_ids
• struct sst_cmd_set_swm
• struct sst_cmd_set_media_path
• struct pcm_cfg
• struct sst_cmd_set_speech_path
• struct gain_cell
• struct sst_cmd_set_gain_dual
• struct sst_cmd_set_params
• struct sst_cmd_sba_vb_start
• struct sst_cmd_sba_set_media_loop_map
• struct sst_cmd_tone_stop
• struct sst_cmd_sba_hw_set_ssp
• struct sst_param_sba_ssp_slot_map
• struct sst_module
• struct sst_ssp_config
• struct sst_ssp_cfg
• struct sst_ids
• struct sst_gain_mixer_control
• struct sst_gain_value
• struct sst_algo_control
• struct sst_enum
• enum sst_path_index
• enum sst_swm_inputs
• enum sst_swm_outputs
• enum sst_ipc_msg
• enum sst_cmd_type
• enum sst_task
• enum sst_type
• enum sst_flag
• enum sst_gain_index
• enum sst_module_id
• enum sst_cmd
• enum sst_dsp_switch
• enum sst_path_switch
• enum sst_swm_state
• enum sst_ssp_mode
• enum sst_ssp_pcm_mode
• enum sst_ssp_duplex
• enum sst_ssp_fs_frequency
• enum sst_ssp_fs_polarity
• enum sst_ssp_protocol
• enum sst_ssp_port_id
• enum sst_gain_kcontrol_type
• enum sst_algo_kcontrol_type

Annotated Snippet

struct sst_destination_id {
	union sst_location_id {
		struct {
			u8 cell_nbr_idx;	/* module index */
			u8 path_id;		/* pipe_id */
		} __packed	p;		/* part */
		u16		f;		/* full */
	} __packed location_id;
	u16	   module_id;
} __packed;
struct sst_dsp_header {
	struct sst_destination_id dst;
	u16 command_id;
	u16 length;
} __packed;

/*
 *
 * Common Commands
 *
 */
struct sst_cmd_generic {
	struct sst_dsp_header header;
} __packed;

struct swm_input_ids {
	struct sst_destination_id input_id;
} __packed;

struct sst_cmd_set_swm {
	struct sst_dsp_header header;
	struct sst_destination_id output_id;
	u16    switch_state;
	u16    nb_inputs;
	struct swm_input_ids input[SST_CMD_SWM_MAX_INPUTS];
} __packed;

struct sst_cmd_set_media_path {
	struct sst_dsp_header header;
	u16    switch_state;
} __packed;

struct pcm_cfg {
		u8 s_length:2;
		u8 rate:3;
		u8 format:3;
} __packed;

struct sst_cmd_set_speech_path {
	struct sst_dsp_header header;
	u16    switch_state;
	struct {
		u16 rsvd:8;
		struct pcm_cfg cfg;
	} config;
} __packed;

struct gain_cell {
	struct sst_destination_id dest;
	s16 cell_gain_left;
	s16 cell_gain_right;
	u16 gain_time_constant;
} __packed;

#define NUM_GAIN_CELLS 1
struct sst_cmd_set_gain_dual {
	struct sst_dsp_header header;
	u16    gain_cell_num;
	struct gain_cell cell_gains[NUM_GAIN_CELLS];
} __packed;
struct sst_cmd_set_params {
	struct sst_destination_id dst;
	u16 command_id;
	char params[];
} __packed;


struct sst_cmd_sba_vb_start {
	struct sst_dsp_header header;
} __packed;

union sba_media_loop_params {
	struct {
		u16 rsvd:8;
		struct pcm_cfg cfg;
	} part;
	u16 full;
} __packed;

struct sst_cmd_sba_set_media_loop_map {

Annotation

• Immediate include surface: `sound/soc.h`, `sound/tlv.h`.
• Detected declarations: `struct sst_destination_id`, `struct sst_dsp_header`, `struct sst_cmd_generic`, `struct swm_input_ids`, `struct sst_cmd_set_swm`, `struct sst_cmd_set_media_path`, `struct pcm_cfg`, `struct sst_cmd_set_speech_path`, `struct gain_cell`, `struct sst_cmd_set_gain_dual`.
• Atlas domain: Driver Families / sound/soc.
• Implementation status: source implementation candidate.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.