2 * sst.h - Intel SST Driver for audio engine
4 * Copyright (C) 2008-14 Intel Corporation
5 * Authors: Vinod Koul <vinod.koul@intel.com>
6 * Harsha Priya <priya.harsha@intel.com>
7 * Dharageswari R <dharageswari.r@intel.com>
8 * KP Jeeja <jeeja.kp@intel.com>
9 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; version 2 of the License.
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22 * Common private declarations for SST
27 #include <linux/firmware.h>
30 #define SST_DRV_NAME "intel_sst_driver"
31 #define SST_MRFLD_PCI_ID 0x119A
32 #define SST_BYT_ACPI_ID 0x80860F28
34 #define SST_SUSPEND_DELAY 2000
35 #define FW_CONTEXT_MEM (64*1024)
36 #define SST_ICCM_BOUNDARY 4
37 #define SST_CONFIG_SSP_SIGN 0x7ffe8001
39 #define MRFLD_FW_VIRTUAL_BASE 0xC0000000
40 #define MRFLD_FW_DDR_BASE_OFFSET 0x0
41 #define MRFLD_FW_FEATURE_BASE_OFFSET 0x4
42 #define MRFLD_FW_BSS_RESET_BIT 0
44 extern const struct dev_pm_ops intel_sst_pm
;
57 #define SST_BLOCK_TIMEOUT 1000
59 #define FW_SIGNATURE_SIZE 4
62 enum sst_stream_states
{
63 STREAM_UN_INIT
= 0, /* Freed/Not used stream */
64 STREAM_RUNNING
= 1, /* Running */
65 STREAM_PAUSED
= 2, /* Paused stream */
66 STREAM_DECODE
= 3, /* stream is in decoding only state */
67 STREAM_INIT
= 4, /* stream init, waiting for data */
68 STREAM_RESET
= 5, /* force reset on recovery */
75 SST_CUSTOM_INFO
= 7, /* consists of FW binary information */
78 /* SST shim registers to structure mapping */
115 union config_status_reg_mrfld
{
118 u64 lpe_reset_vector
:1;
135 union interrupt_reg_mrfld
{
137 u64 done_interrupt
:1;
138 u64 busy_interrupt
:1;
144 union sst_imr_reg_mrfld
{
146 u64 done_interrupt
:1;
147 u64 busy_interrupt
:1;
154 * struct sst_block - This structure is used to block a user/fw data call to another
157 * @condition: condition for blocking check
158 * @ret_code: ret code when block is released
160 * @size: size of data
161 * @on: block condition
162 * @msg_id: msg_id = msgid in mfld/ctp, mrfld = NULL
163 * @drv_id: str_id in mfld/ctp, = drv_id in mrfld
164 * @node: list head node
174 struct list_head node
;
178 * struct stream_info - structure that holds the stream information
180 * @status : stream current state
181 * @prev : stream prev state
182 * @ops : stream operation pb/cp/drm...
183 * @bufs: stream buffer list
184 * @lock : stream mutex for protecting state
185 * @pcm_substream : PCM substream
186 * @period_elapsed : PCM period elapsed callback
187 * @sfreq : stream sampling freq
188 * @str_type : stream type
189 * @cumm_bytes : cummulative bytes decoded
190 * @str_type : stream type
191 * @src : stream source
200 void (*period_elapsed
)(void *pcm_substream
);
205 void *compr_cb_param
;
206 void (*compr_cb
)(void *compr_cb_param
);
208 void *drain_cb_param
;
209 void (*drain_notify
)(void *drain_cb_param
);
212 unsigned int pipe_id
;
214 unsigned int task_id
;
217 #define SST_FW_SIGN "$SST"
218 #define SST_FW_LIB_SIGN "$LIB"
221 * struct sst_fw_header - FW file headers
223 * @signature : FW signature
224 * @file_size: size of fw image
225 * @modules : # of modules
226 * @file_format : version of header format
227 * @reserved : reserved fields
229 struct sst_fw_header
{
230 unsigned char signature
[FW_SIGNATURE_SIZE
];
238 * struct fw_module_header - module header in FW
240 * @signature: module signature
241 * @mod_size: size of module
242 * @blocks: block count
244 * @entry_point: module netry point
246 struct fw_module_header
{
247 unsigned char signature
[FW_SIGNATURE_SIZE
];
255 * struct fw_block_info - block header for FW
257 * @type: block ram type I/D
258 * @size: size of block
259 * @ram_offset: offset in ram
261 struct fw_block_info
{
262 enum sst_ram_type type
;
268 struct sst_runtime_param
{
269 struct snd_sst_runtime_params param
;
273 struct scatterlist
*src
;
274 struct scatterlist
*dst
;
279 struct sst_memcpy_list
{
280 struct list_head memcpylist
;
287 /*Firmware Module Information*/
288 enum sst_lib_dwnld_status
{
289 SST_LIB_NOT_FOUND
= 0,
294 struct sst_module_info
{
295 const char *name
; /*Library name*/
296 u32 id
; /*Module ID*/
297 u32 entry_pt
; /*Module entry point*/
298 u8 status
; /*module status*/
304 * Structure for managing the Library Region(1.5MB)
305 * in DDR in Merrifield
308 phys_addr_t current_base
;
318 struct sst_shim_regs64
{
339 * struct intel_sst_drv - driver ops
341 * @sst_state : current sst device state
342 * @dev_id : device identifier, pci_id for pci devices and acpi_id for acpi
344 * @shim : SST shim pointer
345 * @mailbox : SST mailbox pointer
346 * @iram : SST IRAM pointer
347 * @dram : SST DRAM pointer
348 * @pdata : SST info passed as a part of pci platform data
349 * @shim_phy_add : SST shim phy addr
350 * @shim_regs64: Struct to save shim registers
351 * @ipc_dispatch_list : ipc messages dispatched
352 * @rx_list : to copy the process_reply/process_msg from DSP
353 * @ipc_post_msg_wq : wq to post IPC messages context
354 * @mad_ops : MAD driver operations registered
355 * @mad_wq : MAD driver wq
356 * @post_msg_wq : wq to post IPC messages
357 * @streams : sst stream contexts
358 * @list_lock : sst driver list lock (deprecated)
359 * @ipc_spin_lock : spin lock to handle audio shim access and ipc queue
360 * @block_lock : spin lock to add block to block_list and assign pvt_id
361 * @rx_msg_lock : spin lock to handle the rx messages from the DSP
362 * @scard_ops : sst card ops
363 * @pci : sst pci device struture
364 * @dev : pointer to current device struct
365 * @sst_lock : sst device lock
366 * @pvt_id : sst private id
367 * @stream_cnt : total sst active stream count
368 * @pb_streams : total active pb streams
369 * @cp_streams : total active cp streams
370 * @audio_start : audio status
371 * @qos : PM Qos struct
372 * firmware_name : Firmware / Library name
374 struct intel_sst_drv
{
380 void __iomem
*mailbox
;
383 unsigned int mailbox_add
;
384 unsigned int iram_base
;
385 unsigned int dram_base
;
386 unsigned int shim_phy_add
;
387 unsigned int iram_end
;
388 unsigned int dram_end
;
389 unsigned int ddr_end
;
390 unsigned int ddr_base
;
391 unsigned int mailbox_recv_offset
;
392 struct sst_shim_regs64
*shim_regs64
;
393 struct list_head block_list
;
394 struct list_head ipc_dispatch_list
;
395 struct sst_platform_info
*pdata
;
396 struct list_head rx_list
;
397 struct work_struct ipc_post_msg_wq
;
398 wait_queue_head_t wait_queue
;
399 struct workqueue_struct
*post_msg_wq
;
401 /* str_id 0 is not used */
402 struct stream_info streams
[MAX_NUM_STREAMS
+1];
403 spinlock_t ipc_spin_lock
;
404 spinlock_t block_lock
;
405 spinlock_t rx_msg_lock
;
408 volatile long unsigned pvt_id
;
409 struct mutex sst_lock
;
410 unsigned int stream_cnt
;
411 unsigned int csr_value
;
413 struct sst_sg_list fw_sg_list
, library_list
;
414 struct intel_sst_ops
*ops
;
415 struct sst_info info
;
416 struct pm_qos_request
*qos
;
417 unsigned int use_dma
;
418 unsigned int use_lli
;
419 atomic_t fw_clear_context
;
421 struct list_head memcpy_list
;
422 struct sst_ipc_reg ipc_reg
;
423 struct sst_mem_mgr lib_mem_mgr
;
425 * Holder for firmware name. Due to async call it needs to be
426 * persistent till worker thread gets called
428 char firmware_name
[20];
431 /* misc definitions */
432 #define FW_DWNL_ID 0x01
434 struct intel_sst_ops
{
435 irqreturn_t (*interrupt
)(int, void *);
436 irqreturn_t (*irq_thread
)(int, void *);
437 void (*clear_interrupt
)(struct intel_sst_drv
*ctx
);
438 int (*start
)(struct intel_sst_drv
*ctx
);
439 int (*reset
)(struct intel_sst_drv
*ctx
);
440 void (*process_reply
)(struct intel_sst_drv
*ctx
, struct ipc_post
*msg
);
441 int (*post_message
)(struct intel_sst_drv
*ctx
,
442 struct ipc_post
*msg
, bool sync
);
443 void (*process_message
)(struct ipc_post
*msg
);
444 void (*set_bypass
)(bool set
);
445 int (*save_dsp_context
)(struct intel_sst_drv
*sst
);
446 void (*restore_dsp_context
)(void);
447 int (*alloc_stream
)(struct intel_sst_drv
*ctx
, void *params
);
448 void (*post_download
)(struct intel_sst_drv
*sst
);
451 int sst_pause_stream(struct intel_sst_drv
*sst_drv_ctx
, int id
);
452 int sst_resume_stream(struct intel_sst_drv
*sst_drv_ctx
, int id
);
453 int sst_drop_stream(struct intel_sst_drv
*sst_drv_ctx
, int id
);
454 int sst_free_stream(struct intel_sst_drv
*sst_drv_ctx
, int id
);
455 int sst_start_stream(struct intel_sst_drv
*sst_drv_ctx
, int str_id
);
456 int sst_send_byte_stream_mrfld(struct intel_sst_drv
*ctx
,
457 struct snd_sst_bytes_v2
*sbytes
);
458 int sst_set_stream_param(int str_id
, struct snd_sst_params
*str_param
);
459 int sst_set_metadata(int str_id
, char *params
);
460 int sst_get_stream(struct intel_sst_drv
*sst_drv_ctx
,
461 struct snd_sst_params
*str_param
);
462 int sst_get_stream_allocated(struct intel_sst_drv
*ctx
,
463 struct snd_sst_params
*str_param
,
464 struct snd_sst_lib_download
**lib_dnld
);
465 int sst_drain_stream(struct intel_sst_drv
*sst_drv_ctx
,
466 int str_id
, bool partial_drain
);
467 int sst_post_message_mrfld(struct intel_sst_drv
*ctx
,
468 struct ipc_post
*msg
, bool sync
);
469 void sst_process_reply_mrfld(struct intel_sst_drv
*ctx
, struct ipc_post
*msg
);
470 int sst_start_mrfld(struct intel_sst_drv
*ctx
);
471 int intel_sst_reset_dsp_mrfld(struct intel_sst_drv
*ctx
);
472 void intel_sst_clear_intr_mrfld(struct intel_sst_drv
*ctx
);
474 int sst_load_fw(struct intel_sst_drv
*ctx
);
475 int sst_load_library(struct snd_sst_lib_download
*lib
, u8 ops
);
476 void sst_post_download_mrfld(struct intel_sst_drv
*ctx
);
477 int sst_get_block_stream(struct intel_sst_drv
*sst_drv_ctx
);
478 void sst_memcpy_free_resources(struct intel_sst_drv
*ctx
);
480 int sst_wait_interruptible(struct intel_sst_drv
*sst_drv_ctx
,
481 struct sst_block
*block
);
482 int sst_wait_timeout(struct intel_sst_drv
*sst_drv_ctx
,
483 struct sst_block
*block
);
484 int sst_create_ipc_msg(struct ipc_post
**arg
, bool large
);
485 int free_stream_context(struct intel_sst_drv
*ctx
, unsigned int str_id
);
486 void sst_clean_stream(struct stream_info
*stream
);
487 int intel_sst_register_compress(struct intel_sst_drv
*sst
);
488 int intel_sst_remove_compress(struct intel_sst_drv
*sst
);
489 void sst_cdev_fragment_elapsed(struct intel_sst_drv
*ctx
, int str_id
);
490 int sst_send_sync_msg(int ipc
, int str_id
);
491 int sst_get_num_channel(struct snd_sst_params
*str_param
);
492 int sst_get_sfreq(struct snd_sst_params
*str_param
);
493 int sst_alloc_stream_mrfld(struct intel_sst_drv
*sst_drv_ctx
, void *params
);
494 void sst_restore_fw_context(void);
495 struct sst_block
*sst_create_block(struct intel_sst_drv
*ctx
,
496 u32 msg_id
, u32 drv_id
);
497 int sst_create_block_and_ipc_msg(struct ipc_post
**arg
, bool large
,
498 struct intel_sst_drv
*sst_drv_ctx
, struct sst_block
**block
,
499 u32 msg_id
, u32 drv_id
);
500 int sst_free_block(struct intel_sst_drv
*ctx
, struct sst_block
*freed
);
501 int sst_wake_up_block(struct intel_sst_drv
*ctx
, int result
,
502 u32 drv_id
, u32 ipc
, void *data
, u32 size
);
503 int sst_request_firmware_async(struct intel_sst_drv
*ctx
);
504 int sst_driver_ops(struct intel_sst_drv
*sst
);
505 struct sst_platform_info
*sst_get_acpi_driver_data(const char *hid
);
506 void sst_firmware_load_cb(const struct firmware
*fw
, void *context
);
507 int sst_prepare_and_post_msg(struct intel_sst_drv
*sst
,
508 int task_id
, int ipc_msg
, int cmd_id
, int pipe_id
,
509 size_t mbox_data_len
, const void *mbox_data
, void **data
,
510 bool large
, bool fill_dsp
, bool sync
, bool response
);
512 void sst_process_pending_msg(struct work_struct
*work
);
513 int sst_assign_pvt_id(struct intel_sst_drv
*sst_drv_ctx
);
514 void sst_init_stream(struct stream_info
*stream
,
515 int codec
, int sst_id
, int ops
, u8 slot
);
516 int sst_validate_strid(struct intel_sst_drv
*sst_drv_ctx
, int str_id
);
517 struct stream_info
*get_stream_info(struct intel_sst_drv
*sst_drv_ctx
,
519 int get_stream_id_mrfld(struct intel_sst_drv
*sst_drv_ctx
,
521 u32
relocate_imr_addr_mrfld(u32 base_addr
);
522 void sst_add_to_dispatch_list_and_post(struct intel_sst_drv
*sst
,
523 struct ipc_post
*msg
);
524 int sst_pm_runtime_put(struct intel_sst_drv
*sst_drv
);
525 int sst_shim_write(void __iomem
*addr
, int offset
, int value
);
526 u32
sst_shim_read(void __iomem
*addr
, int offset
);
527 u64
sst_reg_read64(void __iomem
*addr
, int offset
);
528 int sst_shim_write64(void __iomem
*addr
, int offset
, u64 value
);
529 u64
sst_shim_read64(void __iomem
*addr
, int offset
);
530 void sst_set_fw_state_locked(
531 struct intel_sst_drv
*sst_drv_ctx
, int sst_state
);
532 void sst_fill_header_mrfld(union ipc_header_mrfld
*header
,
533 int msg
, int task_id
, int large
, int drv_id
);
534 void sst_fill_header_dsp(struct ipc_dsp_hdr
*dsp
, int msg
,
535 int pipe_id
, int len
);
537 int sst_register(struct device
*);
538 int sst_unregister(struct device
*);
540 int sst_alloc_drv_context(struct intel_sst_drv
**ctx
,
541 struct device
*dev
, unsigned int dev_id
);
542 int sst_context_init(struct intel_sst_drv
*ctx
);
543 void sst_context_cleanup(struct intel_sst_drv
*ctx
);
544 void sst_configure_runtime_pm(struct intel_sst_drv
*ctx
);