linux/sound/soc/intel/atom/sst-mfld-dsp.h
<<
>>
Prefs
   1#ifndef __SST_MFLD_DSP_H__
   2#define __SST_MFLD_DSP_H__
   3/*
   4 *  sst_mfld_dsp.h - Intel SST Driver for audio engine
   5 *
   6 *  Copyright (C) 2008-14 Intel Corporation
   7 *  Authors:    Vinod Koul <vinod.koul@linux.intel.com>
   8 *  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   9 *
  10 *  This program is free software; you can redistribute it and/or modify
  11 *  it under the terms of the GNU General Public License as published by
  12 *  the Free Software Foundation; version 2 of the License.
  13 *
  14 *  This program is distributed in the hope that it will be useful, but
  15 *  WITHOUT ANY WARRANTY; without even the implied warranty of
  16 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17 *  General Public License for more details.
  18 *
  19 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  20 */
  21
  22#define SST_MAX_BIN_BYTES 1024
  23
  24#define MAX_DBG_RW_BYTES 80
  25#define MAX_NUM_SCATTER_BUFFERS 8
  26#define MAX_LOOP_BACK_DWORDS 8
  27/* IPC base address and mailbox, timestamp offsets */
  28#define SST_MAILBOX_SIZE 0x0400
  29#define SST_MAILBOX_SEND 0x0000
  30#define SST_TIME_STAMP 0x1800
  31#define SST_TIME_STAMP_MRFLD 0x800
  32#define SST_RESERVED_OFFSET 0x1A00
  33#define SST_SCU_LPE_MAILBOX 0x1000
  34#define SST_LPE_SCU_MAILBOX 0x1400
  35#define SST_SCU_LPE_LOG_BUF (SST_SCU_LPE_MAILBOX+16)
  36#define PROCESS_MSG 0x80
  37
  38/* Message ID's for IPC messages */
  39/* Bits B7: SST or IA/SC ; B6-B4: Msg Category; B3-B0: Msg Type */
  40
  41/* I2L Firmware/Codec Download msgs */
  42#define IPC_IA_PREP_LIB_DNLD 0x01
  43#define IPC_IA_LIB_DNLD_CMPLT 0x02
  44#define IPC_IA_GET_FW_VERSION 0x04
  45#define IPC_IA_GET_FW_BUILD_INF 0x05
  46#define IPC_IA_GET_FW_INFO 0x06
  47#define IPC_IA_GET_FW_CTXT 0x07
  48#define IPC_IA_SET_FW_CTXT 0x08
  49#define IPC_IA_PREPARE_SHUTDOWN 0x31
  50/* I2L Codec Config/control msgs */
  51#define IPC_PREP_D3 0x10
  52#define IPC_IA_SET_CODEC_PARAMS 0x10
  53#define IPC_IA_GET_CODEC_PARAMS 0x11
  54#define IPC_IA_SET_PPP_PARAMS 0x12
  55#define IPC_IA_GET_PPP_PARAMS 0x13
  56#define IPC_SST_PERIOD_ELAPSED_MRFLD 0xA
  57#define IPC_IA_ALG_PARAMS 0x1A
  58#define IPC_IA_TUNING_PARAMS 0x1B
  59#define IPC_IA_SET_RUNTIME_PARAMS 0x1C
  60#define IPC_IA_SET_PARAMS 0x1
  61#define IPC_IA_GET_PARAMS 0x2
  62
  63#define IPC_EFFECTS_CREATE 0xE
  64#define IPC_EFFECTS_DESTROY 0xF
  65
  66/* I2L Stream config/control msgs */
  67#define IPC_IA_ALLOC_STREAM_MRFLD 0x2
  68#define IPC_IA_ALLOC_STREAM 0x20 /* Allocate a stream ID */
  69#define IPC_IA_FREE_STREAM_MRFLD 0x03
  70#define IPC_IA_FREE_STREAM 0x21 /* Free the stream ID */
  71#define IPC_IA_SET_STREAM_PARAMS 0x22
  72#define IPC_IA_SET_STREAM_PARAMS_MRFLD 0x12
  73#define IPC_IA_GET_STREAM_PARAMS 0x23
  74#define IPC_IA_PAUSE_STREAM 0x24
  75#define IPC_IA_PAUSE_STREAM_MRFLD 0x4
  76#define IPC_IA_RESUME_STREAM 0x25
  77#define IPC_IA_RESUME_STREAM_MRFLD 0x5
  78#define IPC_IA_DROP_STREAM 0x26
  79#define IPC_IA_DROP_STREAM_MRFLD 0x07
  80#define IPC_IA_DRAIN_STREAM 0x27 /* Short msg with str_id */
  81#define IPC_IA_DRAIN_STREAM_MRFLD 0x8
  82#define IPC_IA_CONTROL_ROUTING 0x29
  83#define IPC_IA_VTSV_UPDATE_MODULES 0x20
  84#define IPC_IA_VTSV_DETECTED 0x21
  85
  86#define IPC_IA_START_STREAM_MRFLD 0X06
  87#define IPC_IA_START_STREAM 0x30 /* Short msg with str_id */
  88
  89#define IPC_IA_SET_GAIN_MRFLD 0x21
  90/* Debug msgs */
  91#define IPC_IA_DBG_MEM_READ 0x40
  92#define IPC_IA_DBG_MEM_WRITE 0x41
  93#define IPC_IA_DBG_LOOP_BACK 0x42
  94#define IPC_IA_DBG_LOG_ENABLE 0x45
  95#define IPC_IA_DBG_SET_PROBE_PARAMS 0x47
  96
  97/* L2I Firmware/Codec Download msgs */
  98#define IPC_IA_FW_INIT_CMPLT 0x81
  99#define IPC_IA_FW_INIT_CMPLT_MRFLD 0x01
 100#define IPC_IA_FW_ASYNC_ERR_MRFLD 0x11
 101
 102/* L2I Codec Config/control msgs */
 103#define IPC_SST_FRAGMENT_ELPASED 0x90 /* Request IA more data */
 104
 105#define IPC_SST_BUF_UNDER_RUN 0x92 /* PB Under run and stopped */
 106#define IPC_SST_BUF_OVER_RUN 0x93 /* CAP Under run and stopped */
 107#define IPC_SST_DRAIN_END 0x94 /* PB Drain complete and stopped */
 108#define IPC_SST_CHNGE_SSP_PARAMS 0x95 /* PB SSP parameters changed */
 109#define IPC_SST_STREAM_PROCESS_FATAL_ERR 0x96/* error in processing a stream */
 110#define IPC_SST_PERIOD_ELAPSED 0x97 /* period elapsed */
 111
 112#define IPC_SST_ERROR_EVENT 0x99 /* Buffer over run occurred */
 113/* L2S messages */
 114#define IPC_SC_DDR_LINK_UP 0xC0
 115#define IPC_SC_DDR_LINK_DOWN 0xC1
 116#define IPC_SC_SET_LPECLK_REQ 0xC2
 117#define IPC_SC_SSP_BIT_BANG 0xC3
 118
 119/* L2I Error reporting msgs */
 120#define IPC_IA_MEM_ALLOC_FAIL 0xE0
 121#define IPC_IA_PROC_ERR 0xE1 /* error in processing a
 122                                        stream can be used by playback and
 123                                        capture modules */
 124
 125/* L2I Debug msgs */
 126#define IPC_IA_PRINT_STRING 0xF0
 127
 128/* Buffer under-run */
 129#define IPC_IA_BUF_UNDER_RUN_MRFLD 0x0B
 130
 131/* Mrfld specific defines:
 132 * For asynchronous messages(INIT_CMPLT, PERIOD_ELAPSED, ASYNC_ERROR)
 133 * received from FW, the format is:
 134 *  - IPC High: pvt_id is set to zero. Always short message.
 135 *  - msg_id is in lower 16-bits of IPC low payload.
 136 *  - pipe_id is in higher 16-bits of IPC low payload for period_elapsed.
 137 *  - error id is in higher 16-bits of IPC low payload for async errors.
 138 */
 139#define SST_ASYNC_DRV_ID 0
 140
 141/* Command Response or Acknowledge message to any IPC message will have
 142 * same message ID and stream ID information which is sent.
 143 * There is no specific Ack message ID. The data field is used as response
 144 * meaning.
 145 */
 146enum ackData {
 147        IPC_ACK_SUCCESS = 0,
 148        IPC_ACK_FAILURE,
 149};
 150
 151enum ipc_ia_msg_id {
 152        IPC_CMD = 1,            /*!< Task Control message ID */
 153        IPC_SET_PARAMS = 2,/*!< Task Set param message ID */
 154        IPC_GET_PARAMS = 3,     /*!< Task Get param message ID */
 155        IPC_INVALID = 0xFF,     /*!<Task Get param message ID */
 156};
 157
 158enum sst_codec_types {
 159        /*  AUDIO/MUSIC CODEC Type Definitions */
 160        SST_CODEC_TYPE_UNKNOWN = 0,
 161        SST_CODEC_TYPE_PCM,     /* Pass through Audio codec */
 162        SST_CODEC_TYPE_MP3,
 163        SST_CODEC_TYPE_MP24,
 164        SST_CODEC_TYPE_AAC,
 165        SST_CODEC_TYPE_AACP,
 166        SST_CODEC_TYPE_eAACP,
 167};
 168
 169enum stream_type {
 170        SST_STREAM_TYPE_NONE = 0,
 171        SST_STREAM_TYPE_MUSIC = 1,
 172};
 173
 174enum sst_error_codes {
 175        /* Error code,response to msgId: Description */
 176        /* Common error codes */
 177        SST_SUCCESS = 0,        /* Success */
 178        SST_ERR_INVALID_STREAM_ID = 1,
 179        SST_ERR_INVALID_MSG_ID = 2,
 180        SST_ERR_INVALID_STREAM_OP = 3,
 181        SST_ERR_INVALID_PARAMS = 4,
 182        SST_ERR_INVALID_CODEC = 5,
 183        SST_ERR_INVALID_MEDIA_TYPE = 6,
 184        SST_ERR_STREAM_ERR = 7,
 185
 186        SST_ERR_STREAM_IN_USE = 15,
 187};
 188
 189struct ipc_dsp_hdr {
 190        u16 mod_index_id:8;             /*!< DSP Command ID specific to tasks */
 191        u16 pipe_id:8;  /*!< instance of the module in the pipeline */
 192        u16 mod_id;             /*!< Pipe_id */
 193        u16 cmd_id;             /*!< Module ID = lpe_algo_types_t */
 194        u16 length;             /*!< Length of the payload only */
 195} __packed;
 196
 197union ipc_header_high {
 198        struct {
 199                u32  msg_id:8;      /* Message ID - Max 256 Message Types */
 200                u32  task_id:4;     /* Task ID associated with this comand */
 201                u32  drv_id:4;    /* Identifier for the driver to track*/
 202                u32  rsvd1:8;       /* Reserved */
 203                u32  result:4;      /* Reserved */
 204                u32  res_rqd:1;     /* Response rqd */
 205                u32  large:1;       /* Large Message if large = 1 */
 206                u32  done:1;        /* bit 30 - Done bit */
 207                u32  busy:1;        /* bit 31 - busy bit*/
 208        } part;
 209        u32 full;
 210} __packed;
 211/* IPC header */
 212union ipc_header_mrfld {
 213        struct {
 214                u32 header_low_payload;
 215                union ipc_header_high header_high;
 216        } p;
 217        u64 full;
 218} __packed;
 219/* CAUTION NOTE: All IPC message body must be multiple of 32 bits.*/
 220
 221/* IPC Header */
 222union ipc_header {
 223        struct {
 224                u32  msg_id:8; /* Message ID - Max 256 Message Types */
 225                u32  str_id:5;
 226                u32  large:1;   /* Large Message if large = 1 */
 227                u32  reserved:2;        /* Reserved for future use */
 228                u32  data:14;   /* Ack/Info for msg, size of msg in Mailbox */
 229                u32  done:1; /* bit 30 */
 230                u32  busy:1; /* bit 31 */
 231        } part;
 232        u32 full;
 233} __packed;
 234
 235/* Firmware build info */
 236struct sst_fw_build_info {
 237        unsigned char  date[16]; /* Firmware build date */
 238        unsigned char  time[16]; /* Firmware build time */
 239} __packed;
 240
 241/* Firmware Version info */
 242struct snd_sst_fw_version {
 243        u8 build;       /* build number*/
 244        u8 minor;       /* minor number*/
 245        u8 major;       /* major number*/
 246        u8 type;        /* build type */
 247};
 248
 249struct ipc_header_fw_init {
 250        struct snd_sst_fw_version fw_version;/* Firmware version details */
 251        struct sst_fw_build_info build_info;
 252        u16 result;     /* Fw init result */
 253        u8 module_id; /* Module ID in case of error */
 254        u8 debug_info; /* Debug info from Module ID in case of fail */
 255} __packed;
 256
 257struct snd_sst_tstamp {
 258        u64 ring_buffer_counter;        /* PB/CP: Bytes copied from/to DDR. */
 259        u64 hardware_counter;       /* PB/CP: Bytes DMAed to/from SSP. */
 260        u64 frames_decoded;
 261        u64 bytes_decoded;
 262        u64 bytes_copied;
 263        u32 sampling_frequency;
 264        u32 channel_peak[8];
 265} __packed;
 266
 267/* Stream type params struture for Alloc stream */
 268struct snd_sst_str_type {
 269        u8 codec_type;          /* Codec type */
 270        u8 str_type;            /* 1 = voice 2 = music */
 271        u8 operation;           /* Playback or Capture */
 272        u8 protected_str;       /* 0=Non DRM, 1=DRM */
 273        u8 time_slots;
 274        u8 reserved;            /* Reserved */
 275        u16 result;             /* Result used for acknowledgment */
 276} __packed;
 277
 278/* Library info structure */
 279struct module_info {
 280        u32 lib_version;
 281        u32 lib_type;/*TBD- KLOCKWORK u8 lib_type;*/
 282        u32 media_type;
 283        u8  lib_name[12];
 284        u32 lib_caps;
 285        unsigned char  b_date[16]; /* Lib build date */
 286        unsigned char  b_time[16]; /* Lib build time */
 287} __packed;
 288
 289/* Library slot info */
 290struct lib_slot_info {
 291        u8  slot_num; /* 1 or 2 */
 292        u8  reserved1;
 293        u16 reserved2;
 294        u32 iram_size; /* slot size in IRAM */
 295        u32 dram_size; /* slot size in DRAM */
 296        u32 iram_offset; /* starting offset of slot in IRAM */
 297        u32 dram_offset; /* starting offset of slot in DRAM */
 298} __packed;
 299
 300struct snd_ppp_mixer_params {
 301        __u32                   type; /*Type of the parameter */
 302        __u32                   size;
 303        __u32                   input_stream_bitmap; /*Input stream Bit Map*/
 304} __packed;
 305
 306struct snd_sst_lib_download {
 307        struct module_info lib_info; /* library info type, capabilities etc */
 308        struct lib_slot_info slot_info; /* slot info to be downloaded */
 309        u32 mod_entry_pt;
 310};
 311
 312struct snd_sst_lib_download_info {
 313        struct snd_sst_lib_download dload_lib;
 314        u16 result;     /* Result used for acknowledgment */
 315        u8 pvt_id; /* Private ID */
 316        u8 reserved;  /* for alignment */
 317};
 318struct snd_pcm_params {
 319        u8 num_chan;    /* 1=Mono, 2=Stereo */
 320        u8 pcm_wd_sz;   /* 16/24 - bit*/
 321        u8 use_offload_path;    /* 0-PCM using period elpased & ALSA interfaces
 322                                   1-PCM stream via compressed interface  */
 323        u8 reserved2;
 324        u32 sfreq;    /* Sampling rate in Hz */
 325        u8 channel_map[8];
 326} __packed;
 327
 328/* MP3 Music Parameters Message */
 329struct snd_mp3_params {
 330        u8  num_chan;   /* 1=Mono, 2=Stereo     */
 331        u8  pcm_wd_sz; /* 16/24 - bit*/
 332        u8  crc_check; /* crc_check - disable (0) or enable (1) */
 333        u8  reserved1; /* unused*/
 334        u16 reserved2;  /* Unused */
 335} __packed;
 336
 337#define AAC_BIT_STREAM_ADTS             0
 338#define AAC_BIT_STREAM_ADIF             1
 339#define AAC_BIT_STREAM_RAW              2
 340
 341/* AAC Music Parameters Message */
 342struct snd_aac_params {
 343        u8 num_chan; /* 1=Mono, 2=Stereo*/
 344        u8 pcm_wd_sz; /* 16/24 - bit*/
 345        u8 bdownsample; /*SBR downsampling 0 - disable 1 -enabled AAC+ only */
 346        u8 bs_format; /* input bit stream format adts=0, adif=1, raw=2 */
 347        u16  reser2;
 348        u32 externalsr; /*sampling rate of basic AAC raw bit stream*/
 349        u8 sbr_signalling;/*disable/enable/set automode the SBR tool.AAC+*/
 350        u8 reser1;
 351        u16  reser3;
 352} __packed;
 353
 354/* WMA Music Parameters Message */
 355struct snd_wma_params {
 356        u8  num_chan;   /* 1=Mono, 2=Stereo */
 357        u8  pcm_wd_sz;  /* 16/24 - bit*/
 358        u16 reserved1;
 359        u32 brate;      /* Use the hard coded value. */
 360        u32 sfreq;      /* Sampling freq eg. 8000, 441000, 48000 */
 361        u32 channel_mask;  /* Channel Mask */
 362        u16 format_tag; /* Format Tag */
 363        u16 block_align;        /* packet size */
 364        u16 wma_encode_opt;/* Encoder option */
 365        u8 op_align;    /* op align 0- 16 bit, 1- MSB, 2 LSB */
 366        u8 reserved;    /* reserved */
 367} __packed;
 368
 369/* Codec params struture */
 370union  snd_sst_codec_params {
 371        struct snd_pcm_params pcm_params;
 372        struct snd_mp3_params mp3_params;
 373        struct snd_aac_params aac_params;
 374        struct snd_wma_params wma_params;
 375} __packed;
 376
 377/* Address and size info of a frame buffer */
 378struct sst_address_info {
 379        u32 addr; /* Address at IA */
 380        u32 size; /* Size of the buffer */
 381};
 382
 383struct snd_sst_alloc_params_ext {
 384        __u16 sg_count;
 385        __u16 reserved;
 386        __u32 frag_size;        /*Number of samples after which period elapsed
 387                                  message is sent valid only if path  = 0*/
 388        struct sst_address_info  ring_buf_info[8];
 389};
 390
 391struct snd_sst_stream_params {
 392        union snd_sst_codec_params uc;
 393} __packed;
 394
 395struct snd_sst_params {
 396        u32 result;
 397        u32 stream_id;
 398        u8 codec;
 399        u8 ops;
 400        u8 stream_type;
 401        u8 device_type;
 402        u8 task;
 403        struct snd_sst_stream_params sparams;
 404        struct snd_sst_alloc_params_ext aparams;
 405};
 406
 407struct snd_sst_alloc_mrfld {
 408        u16 codec_type;
 409        u8 operation;
 410        u8 sg_count;
 411        struct sst_address_info ring_buf_info[8];
 412        u32 frag_size;
 413        u32 ts;
 414        struct snd_sst_stream_params codec_params;
 415} __packed;
 416
 417/* Alloc stream params structure */
 418struct snd_sst_alloc_params {
 419        struct snd_sst_str_type str_type;
 420        struct snd_sst_stream_params stream_params;
 421        struct snd_sst_alloc_params_ext alloc_params;
 422} __packed;
 423
 424/* Alloc stream response message */
 425struct snd_sst_alloc_response {
 426        struct snd_sst_str_type str_type; /* Stream type for allocation */
 427        struct snd_sst_lib_download lib_dnld; /* Valid only for codec dnld */
 428};
 429
 430/* Drop response */
 431struct snd_sst_drop_response {
 432        u32 result;
 433        u32 bytes;
 434};
 435
 436struct snd_sst_async_msg {
 437        u32 msg_id; /* Async msg id */
 438        u32 payload[0];
 439};
 440
 441struct snd_sst_async_err_msg {
 442        u32 fw_resp; /* Firmware Result */
 443        u32 lib_resp; /*Library result */
 444} __packed;
 445
 446struct snd_sst_vol {
 447        u32     stream_id;
 448        s32     volume;
 449        u32     ramp_duration;
 450        u32     ramp_type;              /* Ramp type, default=0 */
 451};
 452
 453/* Gain library parameters for mrfld
 454 * based on DSP command spec v0.82
 455 */
 456struct snd_sst_gain_v2 {
 457        u16 gain_cell_num;  /* num of gain cells to modify*/
 458        u8 cell_nbr_idx; /* instance index*/
 459        u8 cell_path_idx; /* pipe-id */
 460        u16 module_id; /*module id */
 461        u16 left_cell_gain; /* left gain value in dB*/
 462        u16 right_cell_gain; /* right gain value in dB*/
 463        u16 gain_time_const; /* gain time constant*/
 464} __packed;
 465
 466struct snd_sst_mute {
 467        u32     stream_id;
 468        u32     mute;
 469};
 470
 471struct snd_sst_runtime_params {
 472        u8 type;
 473        u8 str_id;
 474        u8 size;
 475        u8 rsvd;
 476        void *addr;
 477} __packed;
 478
 479enum stream_param_type {
 480        SST_SET_TIME_SLOT = 0,
 481        SST_SET_CHANNEL_INFO = 1,
 482        OTHERS = 2, /*reserved for future params*/
 483};
 484
 485/* CSV Voice call routing structure */
 486struct snd_sst_control_routing {
 487        u8 control; /* 0=start, 1=Stop */
 488        u8 reserved[3]; /* Reserved- for 32 bit alignment */
 489};
 490
 491struct ipc_post {
 492        struct list_head node;
 493        union ipc_header header; /* driver specific */
 494        bool is_large;
 495        bool is_process_reply;
 496        union ipc_header_mrfld mrfld_header;
 497        char *mailbox_data;
 498};
 499
 500struct snd_sst_ctxt_params {
 501        u32 address; /* Physical Address in DDR where the context is stored */
 502        u32 size; /* size of the context */
 503};
 504
 505struct snd_sst_lpe_log_params {
 506        u8 dbg_type;
 507        u8 module_id;
 508        u8 log_level;
 509        u8 reserved;
 510} __packed;
 511
 512enum snd_sst_bytes_type {
 513        SND_SST_BYTES_SET = 0x1,
 514        SND_SST_BYTES_GET = 0x2,
 515};
 516
 517struct snd_sst_bytes_v2 {
 518        u8 type;
 519        u8 ipc_msg;
 520        u8 block;
 521        u8 task_id;
 522        u8 pipe_id;
 523        u8 rsvd;
 524        u16 len;
 525        char bytes[0];
 526};
 527
 528#define MAX_VTSV_FILES 2
 529struct snd_sst_vtsv_info {
 530        struct sst_address_info vfiles[MAX_VTSV_FILES];
 531} __packed;
 532
 533#endif /* __SST_MFLD_DSP_H__ */
 534