LXR linux/drivers/net/wireless/ath/ath10k/swap.h

   1/*
   2 * Copyright (c) 2015 Qualcomm Atheros, Inc.
   3 *
   4 * Permission to use, copy, modify, and/or distribute this software for any
   5 * purpose with or without fee is hereby granted, provided that the above
   6 * copyright notice and this permission notice appear in all copies.
   7 *
   8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15 */
  16
  17#ifndef _SWAP_H_
  18#define _SWAP_H_
  19
  20#define ATH10K_SWAP_CODE_SEG_BIN_LEN_MAX        (512 * 1024)
  21#define ATH10K_SWAP_CODE_SEG_MAGIC_BYTES_SZ     12
  22#define ATH10K_SWAP_CODE_SEG_NUM_MAX            16
  23/* Currently only one swap segment is supported */
  24#define ATH10K_SWAP_CODE_SEG_NUM_SUPPORTED      1
  25
  26struct ath10k_fw_file;
  27
  28struct ath10k_swap_code_seg_tlv {
  29        __le32 address;
  30        __le32 length;
  31        u8 data[0];
  32} __packed;
  33
  34struct ath10k_swap_code_seg_tail {
  35        u8 magic_signature[ATH10K_SWAP_CODE_SEG_MAGIC_BYTES_SZ];
  36        __le32 bmi_write_addr;
  37} __packed;
  38
  39union ath10k_swap_code_seg_item {
  40        struct ath10k_swap_code_seg_tlv tlv;
  41        struct ath10k_swap_code_seg_tail tail;
  42} __packed;
  43
  44struct ath10k_swap_code_seg_hw_info {
  45        /* Swap binary image size */
  46        __le32 swap_size;
  47        __le32 num_segs;
  48
  49        /* Swap data size */
  50        __le32 size;
  51        __le32 size_log2;
  52        __le32 bus_addr[ATH10K_SWAP_CODE_SEG_NUM_MAX];
  53        __le64 reserved[ATH10K_SWAP_CODE_SEG_NUM_MAX];
  54} __packed;
  55
  56struct ath10k_swap_code_seg_info {
  57        struct ath10k_swap_code_seg_hw_info seg_hw_info;
  58        void *virt_address[ATH10K_SWAP_CODE_SEG_NUM_SUPPORTED];
  59        u32 target_addr;
  60        dma_addr_t paddr[ATH10K_SWAP_CODE_SEG_NUM_SUPPORTED];
  61};
  62
  63int ath10k_swap_code_seg_configure(struct ath10k *ar,
  64                                   const struct ath10k_fw_file *fw_file);
  65void ath10k_swap_code_seg_release(struct ath10k *ar,
  66                                  struct ath10k_fw_file *fw_file);
  67int ath10k_swap_code_seg_init(struct ath10k *ar,
  68                              struct ath10k_fw_file *fw_file);
  69
  70#endif
  71