1/*
2 * Copyright (c) 2017 Redpine Signals 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 __RSI_HAL_H__
18#define __RSI_HAL_H__
19
20/* Device Operating modes */
21#define DEV_OPMODE_WIFI_ALONE 1
22#define DEV_OPMODE_BT_ALONE 4
23#define DEV_OPMODE_BT_LE_ALONE 8
24#define DEV_OPMODE_BT_DUAL 12
25#define DEV_OPMODE_STA_BT 5
26#define DEV_OPMODE_STA_BT_LE 9
27#define DEV_OPMODE_STA_BT_DUAL 13
28#define DEV_OPMODE_AP_BT 6
29#define DEV_OPMODE_AP_BT_DUAL 14
30
31#define DEV_OPMODE_PARAM_DESC \
32 __stringify(DEV_OPMODE_WIFI_ALONE) "[Wi-Fi alone], " \
33 __stringify(DEV_OPMODE_BT_ALONE) "[BT classic alone], " \
34 __stringify(DEV_OPMODE_BT_LE_ALONE) "[BT LE alone], " \
35 __stringify(DEV_OPMODE_BT_DUAL) "[BT classic + BT LE alone], " \
36 __stringify(DEV_OPMODE_STA_BT) "[Wi-Fi STA + BT classic], " \
37 __stringify(DEV_OPMODE_STA_BT_LE) "[Wi-Fi STA + BT LE], " \
38 __stringify(DEV_OPMODE_STA_BT_DUAL) "[Wi-Fi STA + BT classic + BT LE], " \
39 __stringify(DEV_OPMODE_AP_BT) "[Wi-Fi AP + BT classic], " \
40 __stringify(DEV_OPMODE_AP_BT_DUAL) "[Wi-Fi AP + BT classic + BT LE]"
41
42#define FLASH_WRITE_CHUNK_SIZE (4 * 1024)
43#define FLASH_SECTOR_SIZE (4 * 1024)
44
45#define FLASH_SIZE_ADDR 0x04000016
46#define PING_BUFFER_ADDRESS 0x19000
47#define PONG_BUFFER_ADDRESS 0x1a000
48#define SWBL_REGIN 0x41050034
49#define SWBL_REGOUT 0x4105003c
50#define PING_WRITE 0x1
51#define PONG_WRITE 0x2
52
53#define BL_CMD_TIMEOUT 2000
54#define BL_BURN_TIMEOUT (50 * 1000)
55
56#define REGIN_VALID 0xA
57#define REGIN_INPUT 0xA0
58#define REGOUT_VALID 0xAB
59#define REGOUT_INVALID (~0xAB)
60#define CMD_PASS 0xAA
61#define CMD_FAIL 0xCC
62
63#define LOAD_HOSTED_FW 'A'
64#define BURN_HOSTED_FW 'B'
65#define PING_VALID 'I'
66#define PONG_VALID 'O'
67#define PING_AVAIL 'I'
68#define PONG_AVAIL 'O'
69#define EOF_REACHED 'E'
70#define CHECK_CRC 'K'
71#define POLLING_MODE 'P'
72#define AUTO_READ_MODE 'R'
73#define JUMP_TO_ZERO_PC 'J'
74#define FW_LOADING_SUCCESSFUL 'S'
75#define LOADING_INITIATED '1'
76
77#define RSI_ULP_RESET_REG 0x161
78#define RSI_WATCH_DOG_TIMER_1 0x16c
79#define RSI_WATCH_DOG_TIMER_2 0x16d
80#define RSI_WATCH_DOG_DELAY_TIMER_1 0x16e
81#define RSI_WATCH_DOG_DELAY_TIMER_2 0x16f
82#define RSI_WATCH_DOG_TIMER_ENABLE 0x170
83
84/* Watchdog timer addresses for 9116 */
85#define NWP_AHB_BASE_ADDR 0x41300000
86#define NWP_WWD_INTERRUPT_TIMER (NWP_AHB_BASE_ADDR + 0x300)
87#define NWP_WWD_SYSTEM_RESET_TIMER (NWP_AHB_BASE_ADDR + 0x304)
88#define NWP_WWD_WINDOW_TIMER (NWP_AHB_BASE_ADDR + 0x308)
89#define NWP_WWD_TIMER_SETTINGS (NWP_AHB_BASE_ADDR + 0x30C)
90#define NWP_WWD_MODE_AND_RSTART (NWP_AHB_BASE_ADDR + 0x310)
91#define NWP_WWD_RESET_BYPASS (NWP_AHB_BASE_ADDR + 0x314)
92#define NWP_FSM_INTR_MASK_REG (NWP_AHB_BASE_ADDR + 0x104)
93
94/* Watchdog timer values */
95#define NWP_WWD_INT_TIMER_CLKS 5
96#define NWP_WWD_SYS_RESET_TIMER_CLKS 4
97#define NWP_WWD_TIMER_DISABLE 0xAA0001
98
99#define RSI_ULP_WRITE_0 00
100#define RSI_ULP_WRITE_2 02
101#define RSI_ULP_WRITE_50 50
102
103#define RSI_RESTART_WDT BIT(11)
104#define RSI_BYPASS_ULP_ON_WDT BIT(1)
105
106#define RSI_ULP_TIMER_ENABLE ((0xaa000) | RSI_RESTART_WDT | \
107 RSI_BYPASS_ULP_ON_WDT)
108#define RSI_RF_SPI_PROG_REG_BASE_ADDR 0x40080000
109
110#define RSI_GSPI_CTRL_REG0 (RSI_RF_SPI_PROG_REG_BASE_ADDR)
111#define RSI_GSPI_CTRL_REG1 (RSI_RF_SPI_PROG_REG_BASE_ADDR + 0x2)
112#define RSI_GSPI_DATA_REG0 (RSI_RF_SPI_PROG_REG_BASE_ADDR + 0x4)
113#define RSI_GSPI_DATA_REG1 (RSI_RF_SPI_PROG_REG_BASE_ADDR + 0x6)
114#define RSI_GSPI_DATA_REG2 (RSI_RF_SPI_PROG_REG_BASE_ADDR + 0x8)
115
116#define RSI_GSPI_CTRL_REG0_VALUE 0x340
117
118#define RSI_GSPI_DMA_MODE BIT(13)
119
120#define RSI_GSPI_2_ULP BIT(12)
121#define RSI_GSPI_TRIG BIT(7)
122#define RSI_GSPI_READ BIT(6)
123#define RSI_GSPI_RF_SPI_ACTIVE BIT(8)
124
125/* Boot loader commands */
126#define SEND_RPS_FILE '2'
127
128#define FW_IMAGE_MIN_ADDRESS (68 * 1024)
129#define MAX_FLASH_FILE_SIZE (400 * 1024) //400K
130#define FLASH_START_ADDRESS 16
131
132#define COMMON_HAL_CARD_READY_IND 0x0
133
134#define COMMAN_HAL_WAIT_FOR_CARD_READY 1
135
136#define RSI_DEV_OPMODE_WIFI_ALONE 1
137#define RSI_DEV_COEX_MODE_WIFI_ALONE 1
138
139#define BBP_INFO_40MHZ 0x6
140
141#define FW_FLASH_OFFSET 0x820
142#define LMAC_VER_OFFSET_9113 (FW_FLASH_OFFSET + 0x200)
143#define LMAC_VER_OFFSET_9116 0x22C2
144#define MAX_DWORD_ALIGN_BYTES 64
145#define RSI_COMMON_REG_SIZE 2
146#define RSI_9116_REG_SIZE 4
147#define FW_ALIGN_SIZE 4
148#define RSI_9116_FW_MAGIC_WORD 0x5aa5
149
150#define MEM_ACCESS_CTRL_FROM_HOST 0x41300000
151#define RAM_384K_ACCESS_FROM_TA (BIT(2) | BIT(3) | BIT(4) | BIT(5) | \
152 BIT(20) | BIT(21) | BIT(22) | \
153 BIT(23) | BIT(24) | BIT(25))
154
155struct bl_header {
156 __le32 flags;
157 __le32 image_no;
158 __le32 check_sum;
159 __le32 flash_start_address;
160 __le32 flash_len;
161} __packed;
162
163struct ta_metadata {
164 char *name;
165 unsigned int address;
166};
167
168#define RSI_BL_CTRL_LEN_MASK 0xFFFFFF
169#define RSI_BL_CTRL_SPI_32BIT_MODE BIT(27)
170#define RSI_BL_CTRL_REL_TA_SOFTRESET BIT(28)
171#define RSI_BL_CTRL_START_FROM_ROM_PC BIT(29)
172#define RSI_BL_CTRL_SPI_8BIT_MODE BIT(30)
173#define RSI_BL_CTRL_LAST_ENTRY BIT(31)
174struct bootload_entry {
175 __le32 control;
176 __le32 dst_addr;
177} __packed;
178
179struct bootload_ds {
180 __le16 fixed_pattern;
181 __le16 offset;
182 __le32 reserved;
183 struct bootload_entry bl_entry[7];
184} __packed;
185
186struct rsi_mgmt_desc {
187 __le16 len_qno;
188 u8 frame_type;
189 u8 misc_flags;
190 u8 xtend_desc_size;
191 u8 header_len;
192 __le16 frame_info;
193 __le16 rate_info;
194 __le16 bbp_info;
195 __le16 seq_ctrl;
196 u8 reserved2;
197 u8 sta_id;
198} __packed;
199
200struct rsi_data_desc {
201 __le16 len_qno;
202 u8 cfm_frame_type;
203 u8 misc_flags;
204 u8 xtend_desc_size;
205 u8 header_len;
206 __le16 frame_info;
207 __le16 rate_info;
208 __le16 bbp_info;
209 __le16 mac_flags;
210 u8 qid_tid;
211 u8 sta_id;
212} __packed;
213
214struct rsi_bt_desc {
215 __le16 len_qno;
216 __le16 reserved1;
217 __le32 reserved2;
218 __le32 reserved3;
219 __le16 reserved4;
220 __le16 bt_pkt_type;
221} __packed;
222
223int rsi_hal_device_init(struct rsi_hw *adapter);
224int rsi_prepare_mgmt_desc(struct rsi_common *common, struct sk_buff *skb);
225int rsi_prepare_data_desc(struct rsi_common *common, struct sk_buff *skb);
226int rsi_prepare_beacon(struct rsi_common *common, struct sk_buff *skb);
227int rsi_send_pkt_to_bus(struct rsi_common *common, struct sk_buff *skb);
228int rsi_send_bt_pkt(struct rsi_common *common, struct sk_buff *skb);
229
230#endif
231

source code of linux/drivers/net/wireless/rsi/rsi_hal.h