sound/soc/sof/sof-priv.h

   1 /* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
   2 /*
   3  * This file is provided under a dual BSD/GPLv2 license.  When using or
   4  * redistributing this file, you may do so under either license.
   5  *
   6  * Copyright(c) 2018 Intel Corporation. All rights reserved.
   7  *
   8  * Author: Liam Girdwood <liam.r.girdwood@linux.intel.com>
   9  */
  10
  11 #ifndef __SOUND_SOC_SOF_PRIV_H
  12 #define __SOUND_SOC_SOF_PRIV_H
  13
  14 #include <linux/device.h>
  15 #include <sound/hdaudio.h>
  16 #include <sound/sof.h>
  17 #include <sound/sof/info.h>
  18 #include <sound/sof/pm.h>
  19 #include <sound/sof/trace.h>
  20 #include <uapi/sound/sof/fw.h>
  21 #include <sound/sof/ext_manifest.h>
  22
  23 /* debug flags */
  24 #define SOF_DBG_ENABLE_TRACE    BIT(0)
  25 #define SOF_DBG_RETAIN_CTX      BIT(1)  /* prevent DSP D3 on FW exception */
  26
  27 #define SOF_DBG_DUMP_REGS               BIT(0)
  28 #define SOF_DBG_DUMP_MBOX               BIT(1)
  29 #define SOF_DBG_DUMP_TEXT               BIT(2)
  30 #define SOF_DBG_DUMP_PCI                BIT(3)
  31 #define SOF_DBG_DUMP_FORCE_ERR_LEVEL    BIT(4) /* used to dump dsp status with error log level */
  32
  33
  34 /* global debug state set by SOF_DBG_ flags */
  35 extern int sof_core_debug;
  36
  37 /* max BARs mmaped devices can use */
  38 #define SND_SOF_BARS    8
  39
  40 /* time in ms for runtime suspend delay */
  41 #define SND_SOF_SUSPEND_DELAY_MS        2000
  42
  43 /* DMA buffer size for trace */
  44 #define DMA_BUF_SIZE_FOR_TRACE (PAGE_SIZE * 16)
  45
  46 #define SOF_IPC_DSP_REPLY               0
  47 #define SOF_IPC_HOST_REPLY              1
  48
  49 /* convenience constructor for DAI driver streams */
  50 #define SOF_DAI_STREAM(sname, scmin, scmax, srates, sfmt) \
  51         {.stream_name = sname, .channels_min = scmin, .channels_max = scmax, \
  52          .rates = srates, .formats = sfmt}
  53
  54 #define SOF_FORMATS (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S24_LE | \
  55         SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_FLOAT)
  56
  57 #define ENABLE_DEBUGFS_CACHEBUF \
  58         (IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_ENABLE_DEBUGFS_CACHE) || \
  59          IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST))
  60
  61 /* So far the primary core on all DSPs has ID 0 */
  62 #define SOF_DSP_PRIMARY_CORE 0
  63
  64 /* DSP power state */
  65 enum sof_dsp_power_states {
  66         SOF_DSP_PM_D0,
  67         SOF_DSP_PM_D1,
  68         SOF_DSP_PM_D2,
  69         SOF_DSP_PM_D3_HOT,
  70         SOF_DSP_PM_D3,
  71         SOF_DSP_PM_D3_COLD,
  72 };
  73
  74 struct sof_dsp_power_state {
  75         u32 state;
  76         u32 substate; /* platform-specific */
  77 };
  78
  79 /* System suspend target state */
  80 enum sof_system_suspend_state {
  81         SOF_SUSPEND_NONE = 0,
  82         SOF_SUSPEND_S0IX,
  83         SOF_SUSPEND_S3,
  84 };
  85
  86 struct snd_sof_dev;
  87 struct snd_sof_ipc_msg;
  88 struct snd_sof_ipc;
  89 struct snd_sof_debugfs_map;
  90 struct snd_soc_tplg_ops;
  91 struct snd_soc_component;
  92 struct snd_sof_pdata;
  93
  94 /*
  95  * SOF DSP HW abstraction operations.
  96  * Used to abstract DSP HW architecture and any IO busses between host CPU
  97  * and DSP device(s).
  98  */
  99 struct snd_sof_dsp_ops {
 100
 101         /* probe/remove/shutdown */
 102         int (*probe)(struct snd_sof_dev *sof_dev); /* mandatory */
 103         int (*remove)(struct snd_sof_dev *sof_dev); /* optional */
 104         int (*shutdown)(struct snd_sof_dev *sof_dev); /* optional */
 105
 106         /* DSP core boot / reset */
 107         int (*run)(struct snd_sof_dev *sof_dev); /* mandatory */
 108         int (*stall)(struct snd_sof_dev *sof_dev, unsigned int core_mask); /* optional */
 109         int (*reset)(struct snd_sof_dev *sof_dev); /* optional */
 110         int (*core_power_up)(struct snd_sof_dev *sof_dev,
 111                              unsigned int core_mask); /* optional */
 112         int (*core_power_down)(struct snd_sof_dev *sof_dev,
 113                                unsigned int core_mask); /* optional */
 114
 115         /*
 116          * Register IO: only used by respective drivers themselves,
 117          * TODO: consider removing these operations and calling respective
 118          * implementations directly
 119          */
 120         void (*write)(struct snd_sof_dev *sof_dev, void __iomem *addr,
 121                       u32 value); /* optional */
 122         u32 (*read)(struct snd_sof_dev *sof_dev,
 123                     void __iomem *addr); /* optional */
 124         void (*write64)(struct snd_sof_dev *sof_dev, void __iomem *addr,
 125                         u64 value); /* optional */
 126         u64 (*read64)(struct snd_sof_dev *sof_dev,
 127                       void __iomem *addr); /* optional */
 128
 129         /* memcpy IO */
 130         void (*block_read)(struct snd_sof_dev *sof_dev, u32 bar,
 131                            u32 offset, void *dest,
 132                            size_t size); /* mandatory */
 133         void (*block_write)(struct snd_sof_dev *sof_dev, u32 bar,
 134                             u32 offset, void *src,
 135                             size_t size); /* mandatory */
 136
 137         /* doorbell */
 138         irqreturn_t (*irq_handler)(int irq, void *context); /* optional */
 139         irqreturn_t (*irq_thread)(int irq, void *context); /* optional */
 140
 141         /* ipc */
 142         int (*send_msg)(struct snd_sof_dev *sof_dev,
 143                         struct snd_sof_ipc_msg *msg); /* mandatory */
 144
 145         /* FW loading */
 146         int (*load_firmware)(struct snd_sof_dev *sof_dev); /* mandatory */
 147         int (*load_module)(struct snd_sof_dev *sof_dev,
 148                            struct snd_sof_mod_hdr *hdr); /* optional */
 149         /*
 150          * FW ready checks for ABI compatibility and creates
 151          * memory windows at first boot
 152          */
 153         int (*fw_ready)(struct snd_sof_dev *sdev, u32 msg_id); /* mandatory */
 154
 155         /* connect pcm substream to a host stream */
 156         int (*pcm_open)(struct snd_sof_dev *sdev,
 157                         struct snd_pcm_substream *substream); /* optional */
 158         /* disconnect pcm substream to a host stream */
 159         int (*pcm_close)(struct snd_sof_dev *sdev,
 160                          struct snd_pcm_substream *substream); /* optional */
 161
 162         /* host stream hw params */
 163         int (*pcm_hw_params)(struct snd_sof_dev *sdev,
 164                              struct snd_pcm_substream *substream,
 165                              struct snd_pcm_hw_params *params,
 166                              struct sof_ipc_stream_params *ipc_params); /* optional */
 167
 168         /* host stream hw_free */
 169         int (*pcm_hw_free)(struct snd_sof_dev *sdev,
 170                            struct snd_pcm_substream *substream); /* optional */
 171
 172         /* host stream trigger */
 173         int (*pcm_trigger)(struct snd_sof_dev *sdev,
 174                            struct snd_pcm_substream *substream,
 175                            int cmd); /* optional */
 176
 177         /* host stream pointer */
 178         snd_pcm_uframes_t (*pcm_pointer)(struct snd_sof_dev *sdev,
 179                                          struct snd_pcm_substream *substream); /* optional */
 180
 181 #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_PROBES)
 182         /* Except for probe_pointer, all probe ops are mandatory */
 183         int (*probe_assign)(struct snd_sof_dev *sdev,
 184                         struct snd_compr_stream *cstream,
 185                         struct snd_soc_dai *dai); /* mandatory */
 186         int (*probe_free)(struct snd_sof_dev *sdev,
 187                         struct snd_compr_stream *cstream,
 188                         struct snd_soc_dai *dai); /* mandatory */
 189         int (*probe_set_params)(struct snd_sof_dev *sdev,
 190                         struct snd_compr_stream *cstream,
 191                         struct snd_compr_params *params,
 192                         struct snd_soc_dai *dai); /* mandatory */
 193         int (*probe_trigger)(struct snd_sof_dev *sdev,
 194                         struct snd_compr_stream *cstream, int cmd,
 195                         struct snd_soc_dai *dai); /* mandatory */
 196         int (*probe_pointer)(struct snd_sof_dev *sdev,
 197                         struct snd_compr_stream *cstream,
 198                         struct snd_compr_tstamp *tstamp,
 199                         struct snd_soc_dai *dai); /* optional */
 200 #endif
 201
 202         /* host read DSP stream data */
 203         void (*ipc_msg_data)(struct snd_sof_dev *sdev,
 204                              struct snd_pcm_substream *substream,
 205                              void *p, size_t sz); /* mandatory */
 206
 207         /* host configure DSP HW parameters */
 208         int (*ipc_pcm_params)(struct snd_sof_dev *sdev,
 209                               struct snd_pcm_substream *substream,
 210                               const struct sof_ipc_pcm_params_reply *reply); /* mandatory */
 211
 212         /* pre/post firmware run */
 213         int (*pre_fw_run)(struct snd_sof_dev *sof_dev); /* optional */
 214         int (*post_fw_run)(struct snd_sof_dev *sof_dev); /* optional */
 215
 216         /* parse platform specific extended manifest, optional */
 217         int (*parse_platform_ext_manifest)(struct snd_sof_dev *sof_dev,
 218                                            const struct sof_ext_man_elem_header *hdr);
 219
 220         /* DSP PM */
 221         int (*suspend)(struct snd_sof_dev *sof_dev,
 222                        u32 target_state); /* optional */
 223         int (*resume)(struct snd_sof_dev *sof_dev); /* optional */
 224         int (*runtime_suspend)(struct snd_sof_dev *sof_dev); /* optional */
 225         int (*runtime_resume)(struct snd_sof_dev *sof_dev); /* optional */
 226         int (*runtime_idle)(struct snd_sof_dev *sof_dev); /* optional */
 227         int (*set_hw_params_upon_resume)(struct snd_sof_dev *sdev); /* optional */
 228         int (*set_power_state)(struct snd_sof_dev *sdev,
 229                                const struct sof_dsp_power_state *target_state); /* optional */
 230
 231         /* DSP clocking */
 232         int (*set_clk)(struct snd_sof_dev *sof_dev, u32 freq); /* optional */
 233
 234         /* debug */
 235         const struct snd_sof_debugfs_map *debug_map; /* optional */
 236         int debug_map_count; /* optional */
 237         void (*dbg_dump)(struct snd_sof_dev *sof_dev,
 238                          u32 flags); /* optional */
 239         void (*ipc_dump)(struct snd_sof_dev *sof_dev); /* optional */
 240
 241         /* host DMA trace initialization */
 242         int (*trace_init)(struct snd_sof_dev *sdev,
 243                           u32 *stream_tag); /* optional */
 244         int (*trace_release)(struct snd_sof_dev *sdev); /* optional */
 245         int (*trace_trigger)(struct snd_sof_dev *sdev,
 246                              int cmd); /* optional */
 247
 248         /* misc */
 249         int (*get_bar_index)(struct snd_sof_dev *sdev,
 250                              u32 type); /* optional */
 251         int (*get_mailbox_offset)(struct snd_sof_dev *sdev);/* mandatory for common loader code */
 252         int (*get_window_offset)(struct snd_sof_dev *sdev,
 253                                  u32 id);/* mandatory for common loader code */
 254
 255         /* machine driver ops */
 256         int (*machine_register)(struct snd_sof_dev *sdev,
 257                                 void *pdata); /* optional */
 258         void (*machine_unregister)(struct snd_sof_dev *sdev,
 259                                    void *pdata); /* optional */
 260         void (*machine_select)(struct snd_sof_dev *sdev); /* optional */
 261         void (*set_mach_params)(const struct snd_soc_acpi_mach *mach,
 262                                 struct device *dev); /* optional */
 263
 264         /* DAI ops */
 265         struct snd_soc_dai_driver *drv;
 266         int num_drv;
 267
 268         /* ALSA HW info flags, will be stored in snd_pcm_runtime.hw.info */
 269         u32 hw_info;
 270
 271         const struct sof_arch_ops *arch_ops;
 272 };
 273
 274 /* DSP architecture specific callbacks for oops and stack dumps */
 275 struct sof_arch_ops {
 276         void (*dsp_oops)(struct snd_sof_dev *sdev, void *oops);
 277         void (*dsp_stack)(struct snd_sof_dev *sdev, void *oops,
 278                           u32 *stack, u32 stack_words);
 279 };
 280
 281 #define sof_arch_ops(sdev) ((sdev)->pdata->desc->ops->arch_ops)
 282
 283 /* DSP device HW descriptor mapping between bus ID and ops */
 284 struct sof_ops_table {
 285         const struct sof_dev_desc *desc;
 286         const struct snd_sof_dsp_ops *ops;
 287 };
 288
 289 enum sof_dfsentry_type {
 290         SOF_DFSENTRY_TYPE_IOMEM = 0,
 291         SOF_DFSENTRY_TYPE_BUF,
 292 };
 293
 294 enum sof_debugfs_access_type {
 295         SOF_DEBUGFS_ACCESS_ALWAYS = 0,
 296         SOF_DEBUGFS_ACCESS_D0_ONLY,
 297 };
 298
 299 /* FS entry for debug files that can expose DSP memories, registers */
 300 struct snd_sof_dfsentry {
 301         size_t size;
 302         size_t buf_data_size;  /* length of buffered data for file read operation */
 303         enum sof_dfsentry_type type;
 304         /*
 305          * access_type specifies if the
 306          * memory -> DSP resource (memory, register etc) is always accessible
 307          * or if it is accessible only when the DSP is in D0.
 308          */
 309         enum sof_debugfs_access_type access_type;
 310 #if ENABLE_DEBUGFS_CACHEBUF
 311         char *cache_buf; /* buffer to cache the contents of debugfs memory */
 312 #endif
 313         struct snd_sof_dev *sdev;
 314         struct list_head list;  /* list in sdev dfsentry list */
 315         union {
 316                 void __iomem *io_mem;
 317                 void *buf;
 318         };
 319 };
 320
 321 /* Debug mapping for any DSP memory or registers that can used for debug */
 322 struct snd_sof_debugfs_map {
 323         const char *name;
 324         u32 bar;
 325         u32 offset;
 326         u32 size;
 327         /*
 328          * access_type specifies if the memory is always accessible
 329          * or if it is accessible only when the DSP is in D0.
 330          */
 331         enum sof_debugfs_access_type access_type;
 332 };
 333
 334 /* mailbox descriptor, used for host <-> DSP IPC */
 335 struct snd_sof_mailbox {
 336         u32 offset;
 337         size_t size;
 338 };
 339
 340 /* IPC message descriptor for host <-> DSP IO */
 341 struct snd_sof_ipc_msg {
 342         /* message data */
 343         u32 header;
 344         void *msg_data;
 345         void *reply_data;
 346         size_t msg_size;
 347         size_t reply_size;
 348         int reply_error;
 349
 350         wait_queue_head_t waitq;
 351         bool ipc_complete;
 352 };
 353
 354 enum snd_sof_fw_state {
 355         SOF_FW_BOOT_NOT_STARTED = 0,
 356         SOF_FW_BOOT_PREPARE,
 357         SOF_FW_BOOT_IN_PROGRESS,
 358         SOF_FW_BOOT_FAILED,
 359         SOF_FW_BOOT_READY_FAILED, /* firmware booted but fw_ready op failed */
 360         SOF_FW_BOOT_COMPLETE,
 361 };
 362
 363 /*
 364  * SOF Device Level.
 365  */
 366 struct snd_sof_dev {
 367         struct device *dev;
 368         spinlock_t ipc_lock;    /* lock for IPC users */
 369         spinlock_t hw_lock;     /* lock for HW IO access */
 370
 371         /*
 372          * ASoC components. plat_drv fields are set dynamically so
 373          * can't use const
 374          */
 375         struct snd_soc_component_driver plat_drv;
 376
 377         /* current DSP power state */
 378         struct sof_dsp_power_state dsp_power_state;
 379         /* mutex to protect the dsp_power_state access */
 380         struct mutex power_state_access;
 381
 382         /* Intended power target of system suspend */
 383         enum sof_system_suspend_state system_suspend_target;
 384
 385         /* DSP firmware boot */
 386         wait_queue_head_t boot_wait;
 387         enum snd_sof_fw_state fw_state;
 388         bool first_boot;
 389
 390         /* work queue in case the probe is implemented in two steps */
 391         struct work_struct probe_work;
 392         bool probe_completed;
 393
 394         /* DSP HW differentiation */
 395         struct snd_sof_pdata *pdata;
 396
 397         /* IPC */
 398         struct snd_sof_ipc *ipc;
 399         struct snd_sof_mailbox dsp_box;         /* DSP initiated IPC */
 400         struct snd_sof_mailbox host_box;        /* Host initiated IPC */
 401         struct snd_sof_mailbox stream_box;      /* Stream position update */
 402         struct snd_sof_mailbox debug_box;       /* Debug info updates */
 403         struct snd_sof_ipc_msg *msg;
 404         int ipc_irq;
 405         u32 next_comp_id; /* monotonic - reset during S3 */
 406
 407         /* memory bases for mmaped DSPs - set by dsp_init() */
 408         void __iomem *bar[SND_SOF_BARS];        /* DSP base address */
 409         int mmio_bar;
 410         int mailbox_bar;
 411         size_t dsp_oops_offset;
 412
 413         /* debug */
 414         struct dentry *debugfs_root;
 415         struct list_head dfsentry_list;
 416
 417         /* firmware loader */
 418         struct snd_dma_buffer dmab;
 419         struct snd_dma_buffer dmab_bdl;
 420         struct sof_ipc_fw_ready fw_ready;
 421         struct sof_ipc_fw_version fw_version;
 422         struct sof_ipc_cc_version *cc_version;
 423
 424         /* topology */
 425         struct snd_soc_tplg_ops *tplg_ops;
 426         struct list_head pcm_list;
 427         struct list_head kcontrol_list;
 428         struct list_head widget_list;
 429         struct list_head dai_list;
 430         struct list_head route_list;
 431         struct snd_soc_component *component;
 432         u32 enabled_cores_mask; /* keep track of enabled cores */
 433
 434         /* FW configuration */
 435         struct sof_ipc_window *info_window;
 436
 437         /* IPC timeouts in ms */
 438         int ipc_timeout;
 439         int boot_timeout;
 440
 441 #if IS_ENABLED(CONFIG_SND_SOC_SOF_DEBUG_PROBES)
 442         unsigned int extractor_stream_tag;
 443 #endif
 444
 445         /* DMA for Trace */
 446         struct snd_dma_buffer dmatb;
 447         struct snd_dma_buffer dmatp;
 448         int dma_trace_pages;
 449         wait_queue_head_t trace_sleep;
 450         u32 host_offset;
 451         bool dtrace_is_supported; /* set with Kconfig or module parameter */
 452         bool dtrace_is_enabled;
 453         bool dtrace_error;
 454         bool dtrace_draining;
 455
 456         bool msi_enabled;
 457
 458         void *private;                  /* core does not touch this */
 459 };
 460
 461 /*
 462  * Device Level.
 463  */
 464
 465 int snd_sof_device_probe(struct device *dev, struct snd_sof_pdata *plat_data);
 466 int snd_sof_device_remove(struct device *dev);
 467 int snd_sof_device_shutdown(struct device *dev);
 468 bool snd_sof_device_probe_completed(struct device *dev);
 469
 470 int snd_sof_runtime_suspend(struct device *dev);
 471 int snd_sof_runtime_resume(struct device *dev);
 472 int snd_sof_runtime_idle(struct device *dev);
 473 int snd_sof_resume(struct device *dev);
 474 int snd_sof_suspend(struct device *dev);
 475 int snd_sof_dsp_power_down_notify(struct snd_sof_dev *sdev);
 476 int snd_sof_prepare(struct device *dev);
 477 void snd_sof_complete(struct device *dev);
 478
 479 void snd_sof_new_platform_drv(struct snd_sof_dev *sdev);
 480
 481 int snd_sof_create_page_table(struct device *dev,
 482                               struct snd_dma_buffer *dmab,
 483                               unsigned char *page_table, size_t size);
 484
 485 /*
 486  * Firmware loading.
 487  */
 488 int snd_sof_load_firmware(struct snd_sof_dev *sdev);
 489 int snd_sof_load_firmware_raw(struct snd_sof_dev *sdev);
 490 int snd_sof_load_firmware_memcpy(struct snd_sof_dev *sdev);
 491 int snd_sof_run_firmware(struct snd_sof_dev *sdev);
 492 int snd_sof_parse_module_memcpy(struct snd_sof_dev *sdev,
 493                                 struct snd_sof_mod_hdr *module);
 494 void snd_sof_fw_unload(struct snd_sof_dev *sdev);
 495 int snd_sof_fw_parse_ext_data(struct snd_sof_dev *sdev, u32 bar, u32 offset);
 496
 497 /*
 498  * IPC low level APIs.
 499  */
 500 struct snd_sof_ipc *snd_sof_ipc_init(struct snd_sof_dev *sdev);
 501 void snd_sof_ipc_free(struct snd_sof_dev *sdev);
 502 void snd_sof_ipc_reply(struct snd_sof_dev *sdev, u32 msg_id);
 503 void snd_sof_ipc_msgs_rx(struct snd_sof_dev *sdev);
 504 int snd_sof_ipc_stream_pcm_params(struct snd_sof_dev *sdev,
 505                                   struct sof_ipc_pcm_params *params);
 506 int snd_sof_dsp_mailbox_init(struct snd_sof_dev *sdev, u32 dspbox,
 507                              size_t dspbox_size, u32 hostbox,
 508                              size_t hostbox_size);
 509 int snd_sof_ipc_valid(struct snd_sof_dev *sdev);
 510 int sof_ipc_tx_message(struct snd_sof_ipc *ipc, u32 header,
 511                        void *msg_data, size_t msg_bytes, void *reply_data,
 512                        size_t reply_bytes);
 513 int sof_ipc_tx_message_no_pm(struct snd_sof_ipc *ipc, u32 header,
 514                              void *msg_data, size_t msg_bytes,
 515                              void *reply_data, size_t reply_bytes);
 516
 517 /*
 518  * Trace/debug
 519  */
 520 int snd_sof_init_trace(struct snd_sof_dev *sdev);
 521 void snd_sof_release_trace(struct snd_sof_dev *sdev);
 522 void snd_sof_free_trace(struct snd_sof_dev *sdev);
 523 int snd_sof_dbg_init(struct snd_sof_dev *sdev);
 524 void snd_sof_free_debug(struct snd_sof_dev *sdev);
 525 int snd_sof_debugfs_io_item(struct snd_sof_dev *sdev,
 526                             void __iomem *base, size_t size,
 527                             const char *name,
 528                             enum sof_debugfs_access_type access_type);
 529 int snd_sof_debugfs_buf_item(struct snd_sof_dev *sdev,
 530                              void *base, size_t size,
 531                              const char *name, mode_t mode);
 532 int snd_sof_trace_update_pos(struct snd_sof_dev *sdev,
 533                              struct sof_ipc_dma_trace_posn *posn);
 534 void snd_sof_trace_notify_for_error(struct snd_sof_dev *sdev);
 535 void snd_sof_get_status(struct snd_sof_dev *sdev, u32 panic_code,
 536                         u32 tracep_code, void *oops,
 537                         struct sof_ipc_panic_info *panic_info,
 538                         void *stack, size_t stack_words);
 539 int snd_sof_init_trace_ipc(struct snd_sof_dev *sdev);
 540 void snd_sof_handle_fw_exception(struct snd_sof_dev *sdev);
 541 int snd_sof_dbg_memory_info_init(struct snd_sof_dev *sdev);
 542
 543 /*
 544  * Platform specific ops.
 545  */
 546 extern struct snd_compress_ops sof_compressed_ops;
 547
 548 /*
 549  * DSP Architectures.
 550  */
 551 static inline void sof_stack(struct snd_sof_dev *sdev, void *oops, u32 *stack,
 552                              u32 stack_words)
 553 {
 554                 sof_arch_ops(sdev)->dsp_stack(sdev, oops, stack, stack_words);
 555 }
 556
 557 static inline void sof_oops(struct snd_sof_dev *sdev, void *oops)
 558 {
 559         if (sof_arch_ops(sdev)->dsp_oops)
 560                 sof_arch_ops(sdev)->dsp_oops(sdev, oops);
 561 }
 562
 563 extern const struct sof_arch_ops sof_xtensa_arch_ops;
 564
 565 /*
 566  * Utilities
 567  */
 568 void sof_io_write(struct snd_sof_dev *sdev, void __iomem *addr, u32 value);
 569 void sof_io_write64(struct snd_sof_dev *sdev, void __iomem *addr, u64 value);
 570 u32 sof_io_read(struct snd_sof_dev *sdev, void __iomem *addr);
 571 u64 sof_io_read64(struct snd_sof_dev *sdev, void __iomem *addr);
 572 void sof_mailbox_write(struct snd_sof_dev *sdev, u32 offset,
 573                        void *message, size_t bytes);
 574 void sof_mailbox_read(struct snd_sof_dev *sdev, u32 offset,
 575                       void *message, size_t bytes);
 576 void sof_block_write(struct snd_sof_dev *sdev, u32 bar, u32 offset, void *src,
 577                      size_t size);
 578 void sof_block_read(struct snd_sof_dev *sdev, u32 bar, u32 offset, void *dest,
 579                     size_t size);
 580
 581 int sof_fw_ready(struct snd_sof_dev *sdev, u32 msg_id);
 582
 583 void intel_ipc_msg_data(struct snd_sof_dev *sdev,
 584                         struct snd_pcm_substream *substream,
 585                         void *p, size_t sz);
 586 int intel_ipc_pcm_params(struct snd_sof_dev *sdev,
 587                          struct snd_pcm_substream *substream,
 588                          const struct sof_ipc_pcm_params_reply *reply);
 589
 590 int intel_pcm_open(struct snd_sof_dev *sdev,
 591                    struct snd_pcm_substream *substream);
 592 int intel_pcm_close(struct snd_sof_dev *sdev,
 593                     struct snd_pcm_substream *substream);
 594
 595 int sof_machine_check(struct snd_sof_dev *sdev);
 596
 597 #define sof_dev_dbg_or_err(dev, is_err, fmt, ...)                       \
 598         do {                                                            \
 599                 if (is_err)                                             \
 600                         dev_err(dev, "error: " fmt, __VA_ARGS__);       \
 601                 else                                                    \
 602                         dev_dbg(dev, fmt, __VA_ARGS__);                 \
 603         } while (0)
 604
 605 #endif