drivers/staging/rtl8712/rtl871x_cmd.h

   1 #ifndef __RTL871X_CMD_H_
   2 #define __RTL871X_CMD_H_
   3
   4 #include "wlan_bssdef.h"
   5 #include "rtl871x_rf.h"
   6 #define C2H_MEM_SZ (16*1024)
   7
   8 #include "osdep_service.h"
   9 #include "ieee80211.h"
  10
  11 #define FREE_CMDOBJ_SZ  128
  12 #define MAX_CMDSZ       512
  13 #define MAX_RSPSZ       512
  14 #define MAX_EVTSZ       1024
  15 #define CMDBUFF_ALIGN_SZ 512
  16
  17 struct cmd_obj {
  18         u16     cmdcode;
  19         u8      res;
  20         u8      *parmbuf;
  21         u32     cmdsz;
  22         u8      *rsp;
  23         u32     rspsz;
  24         struct list_head list;
  25 };
  26
  27 struct cmd_priv {
  28         struct semaphore cmd_queue_sema;
  29         struct semaphore terminate_cmdthread_sema;
  30         struct  __queue cmd_queue;
  31         u8 cmd_seq;
  32         u8 *cmd_buf;    /*shall be non-paged, and 4 bytes aligned*/
  33         u8 *cmd_allocated_buf;
  34         u8 *rsp_buf;    /*shall be non-paged, and 4 bytes aligned*/
  35         u8 *rsp_allocated_buf;
  36         u32 cmd_issued_cnt;
  37         u32 cmd_done_cnt;
  38         u32 rsp_cnt;
  39         struct _adapter *padapter;
  40 };
  41
  42 struct evt_obj {
  43         u16 evtcode;
  44         u8 res;
  45         u8 *parmbuf;
  46         u32 evtsz;
  47         struct list_head list;
  48 };
  49
  50 struct  evt_priv {
  51         struct  __queue evt_queue;
  52         u8      event_seq;
  53         u8      *evt_buf;       /*shall be non-paged, and 4 bytes aligned*/
  54         u8      *evt_allocated_buf;
  55         u32     evt_done_cnt;
  56         struct tasklet_struct event_tasklet;
  57 };
  58
  59 #define init_h2fwcmd_w_parm_no_rsp(pcmd, pparm, code) \
  60 do {\
  61         _init_listhead(&pcmd->list);\
  62         pcmd->cmdcode = code;\
  63         pcmd->parmbuf = (u8 *)(pparm);\
  64         pcmd->cmdsz = sizeof(*pparm);\
  65         pcmd->rsp = NULL;\
  66         pcmd->rspsz = 0;\
  67 } while (0)
  68
  69 u32 r8712_enqueue_cmd(struct cmd_priv *pcmdpriv, struct cmd_obj *obj);
  70 u32 r8712_enqueue_cmd_ex(struct cmd_priv *pcmdpriv, struct cmd_obj *obj);
  71 struct cmd_obj *r8712_dequeue_cmd(struct  __queue *queue);
  72 void r8712_free_cmd_obj(struct cmd_obj *pcmd);
  73 int r8712_cmd_thread(void *context);
  74 u32 r8712_init_cmd_priv(struct cmd_priv *pcmdpriv);
  75 void r8712_free_cmd_priv(struct cmd_priv *pcmdpriv);
  76 u32 r8712_init_evt_priv(struct evt_priv *pevtpriv);
  77 void r8712_free_evt_priv(struct evt_priv *pevtpriv);
  78
  79 enum rtl871x_drvint_cid {
  80         NONE_WK_CID,
  81         WDG_WK_CID,
  82         MAX_WK_CID
  83 };
  84
  85 enum RFINTFS {
  86         SWSI,
  87         HWSI,
  88         HWPI,
  89 };
  90
  91 /*
  92  * Caller Mode: Infra, Ad-HoC(C)
  93  * Notes: To enter USB suspend mode
  94  * Command Mode
  95  */
  96 struct usb_suspend_parm {
  97         u32 action; /* 1: sleep, 0:resume */
  98 };
  99
 100 /*
 101  * Caller Mode: Infra, Ad-Hoc
 102  * Notes: To join the specified bss
 103  * Command Event Mode
 104  */
 105 struct joinbss_parm {
 106         struct ndis_wlan_bssid_ex network;
 107 };
 108
 109 /*
 110  * Caller Mode: Infra, Ad-HoC(C)
 111  * Notes: To disconnect the current associated BSS
 112  * Command Mode
 113  */
 114 struct disconnect_parm {
 115         u32 rsvd;
 116 };
 117
 118 /*
 119  * Caller Mode: AP, Ad-HoC(M)
 120  * Notes: To create a BSS
 121  * Command Mode
 122  */
 123 struct createbss_parm {
 124         struct ndis_wlan_bssid_ex network;
 125 };
 126
 127 /*
 128  * Caller Mode: AP, Ad-HoC, Infra
 129  * Notes: To set the NIC mode of RTL8711
 130  * Command Mode
 131  * The definition of mode:
 132  *
 133  * #define IW_MODE_AUTO 0       // Let the driver decides which AP to join
 134  * #define IW_MODE_ADHOC        1       // Single cell network (Ad-Hoc Clients)
 135  * #define IW_MODE_INFRA        2       // Multi cell network, roaming, ..
 136  * #define IW_MODE_MASTER       3       // Synchronisation master or AP
 137  * #define IW_MODE_REPEAT       4       // Wireless Repeater (forwarder)
 138  * #define IW_MODE_SECOND       5       // Secondary master/repeater (backup)
 139  * #define IW_MODE_MONITOR      6       // Passive monitor (listen only)
 140 */
 141 struct  setopmode_parm {
 142         u8      mode;
 143         u8      rsvd[3];
 144 };
 145
 146 /*
 147  * Caller Mode: AP, Ad-HoC, Infra
 148  * Notes: To ask RTL8711 performing site-survey
 149  * Command-Event Mode
 150  */
 151 struct sitesurvey_parm {
 152         sint passive_mode;      /*active: 1, passive: 0 */
 153         sint bsslimit;  /* 1 ~ 48 */
 154         sint    ss_ssidlen;
 155         u8      ss_ssid[IW_ESSID_MAX_SIZE + 1];
 156 };
 157
 158 /*
 159  * Caller Mode: Any
 160  * Notes: To set the auth type of RTL8711. open/shared/802.1x
 161  * Command Mode
 162  */
 163 struct setauth_parm {
 164         u8 mode;  /*0: legacy open, 1: legacy shared 2: 802.1x*/
 165         u8 _1x;   /*0: PSK, 1: TLS*/
 166         u8 rsvd[2];
 167 };
 168
 169 /*
 170  * Caller Mode: Infra
 171  * a. algorithm: wep40, wep104, tkip & aes
 172  * b. keytype: grp key/unicast key
 173  * c. key contents
 174  *
 175  * when shared key ==> keyid is the camid
 176  * when 802.1x ==> keyid [0:1] ==> grp key
 177  * when 802.1x ==> keyid > 2 ==> unicast key
 178  */
 179 struct setkey_parm {
 180         u8      algorithm;      /* encryption algorithm, could be none, wep40,
 181                                  * TKIP, CCMP, wep104 */
 182         u8      keyid;
 183         u8      grpkey;         /* 1: this is the grpkey for 802.1x.
 184                                  * 0: this is the unicast key for 802.1x */
 185         u8      key[16];        /* this could be 40 or 104 */
 186 };
 187
 188 /*
 189  * When in AP or Ad-Hoc mode, this is used to
 190  * allocate an sw/hw entry for a newly associated sta.
 191  * Command
 192  * when shared key ==> algorithm/keyid
 193  */
 194 struct set_stakey_parm {
 195         u8      addr[ETH_ALEN];
 196         u8      algorithm;
 197         u8      key[16];
 198 };
 199
 200 struct set_stakey_rsp {
 201         u8      addr[ETH_ALEN];
 202         u8      keyid;
 203         u8      rsvd;
 204 };
 205
 206 struct SetMacAddr_param {
 207         u8      MacAddr[ETH_ALEN];
 208 };
 209
 210 /*
 211 Caller Ad-Hoc/AP
 212
 213 Command -Rsp(AID == CAMID) mode
 214
 215 This is to force fw to add an sta_data entry per driver's request.
 216
 217 FW will write an cam entry associated with it.
 218
 219 */
 220 struct set_assocsta_parm {
 221         u8      addr[ETH_ALEN];
 222 };
 223
 224 struct set_assocsta_rsp {
 225         u8      cam_id;
 226         u8      rsvd[3];
 227 };
 228
 229 /*
 230         Caller Ad-Hoc/AP
 231
 232         Command mode
 233
 234         This is to force fw to del an sta_data entry per driver's request
 235
 236         FW will invalidate the cam entry associated with it.
 237
 238 */
 239 struct del_assocsta_parm {
 240         u8      addr[ETH_ALEN];
 241 };
 242
 243 /*
 244 Caller Mode: AP/Ad-HoC(M)
 245
 246 Notes: To notify fw that given staid has changed its power state
 247
 248 Command Mode
 249
 250 */
 251 struct setstapwrstate_parm {
 252         u8      staid;
 253         u8      status;
 254         u8      hwaddr[6];
 255 };
 256
 257 /*
 258 Caller Mode: Any
 259
 260 Notes: To setup the basic rate of RTL8711
 261
 262 Command Mode
 263
 264 */
 265 struct  setbasicrate_parm {
 266         u8      basicrates[NumRates];
 267 };
 268
 269 /*
 270 Caller Mode: Any
 271
 272 Notes: To read the current basic rate
 273
 274 Command-Rsp Mode
 275
 276 */
 277 struct getbasicrate_parm {
 278         u32 rsvd;
 279 };
 280
 281 struct getbasicrate_rsp {
 282         u8 basicrates[NumRates];
 283 };
 284
 285 /*
 286 Caller Mode: Any
 287
 288 Notes: To setup the data rate of RTL8711
 289
 290 Command Mode
 291
 292 */
 293 struct setdatarate_parm {
 294         u8      mac_id;
 295         u8      datarates[NumRates];
 296 };
 297
 298 /*
 299 Caller Mode: Any
 300
 301 Notes: To read the current data rate
 302
 303 Command-Rsp Mode
 304
 305 */
 306 struct getdatarate_parm {
 307         u32 rsvd;
 308
 309 };
 310 struct getdatarate_rsp {
 311         u8 datarates[NumRates];
 312 };
 313
 314
 315 /*
 316 Caller Mode: Any
 317 AP: AP can use the info for the contents of beacon frame
 318 Infra: STA can use the info when sitesurveying
 319 Ad-HoC(M): Like AP
 320 Ad-HoC(C): Like STA
 321
 322
 323 Notes: To set the phy capability of the NIC
 324
 325 Command Mode
 326
 327 */
 328
 329 /*
 330 Caller Mode: Any
 331
 332 Notes: To set the channel/modem/band
 333 This command will be used when channel/modem/band is changed.
 334
 335 Command Mode
 336
 337 */
 338 /*
 339 Caller Mode: Any
 340
 341 Notes: To get the current setting of channel/modem/band
 342
 343 Command-Rsp Mode
 344
 345 */
 346 struct  getphy_rsp {
 347         u8      rfchannel;
 348         u8      modem;
 349 };
 350
 351 struct readBB_parm {
 352         u8      offset;
 353 };
 354 struct readBB_rsp {
 355         u8      value;
 356 };
 357
 358 struct readTSSI_parm {
 359         u8      offset;
 360 };
 361 struct readTSSI_rsp {
 362         u8      value;
 363 };
 364
 365 struct writeBB_parm {
 366         u8      offset;
 367         u8      value;
 368 };
 369
 370 struct readRF_parm {
 371         u8      offset;
 372 };
 373 struct readRF_rsp {
 374         u32     value;
 375 };
 376
 377 struct writeRF_parm {
 378         u32     offset;
 379         u32     value;
 380 };
 381
 382 struct setrfintfs_parm {
 383         u8      rfintfs;
 384 };
 385
 386 struct getrfintfs_parm {
 387         u8      rfintfs;
 388 };
 389
 390 /*
 391         Notes: This command is used for H2C/C2H loopback testing
 392
 393         mac[0] == 0
 394         ==> CMD mode, return H2C_SUCCESS.
 395         The following condition must be ture under CMD mode
 396                 mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;
 397                 s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;
 398                 s2 == (b1 << 8 | b0);
 399
 400         mac[0] == 1
 401         ==> CMD_RSP mode, return H2C_SUCCESS_RSP
 402
 403         The rsp layout shall be:
 404         rsp:                    parm:
 405                 mac[0]  =   mac[5];
 406                 mac[1]  =   mac[4];
 407                 mac[2]  =   mac[3];
 408                 mac[3]  =   mac[2];
 409                 mac[4]  =   mac[1];
 410                 mac[5]  =   mac[0];
 411                 s0              =   s1;
 412                 s1              =   swap16(s0);
 413                 w0              =       swap32(w1);
 414                 b0              =       b1
 415                 s2              =       s0 + s1
 416                 b1              =       b0
 417                 w1              =       w0
 418
 419         mac[0] ==       2
 420         ==> CMD_EVENT mode, return      H2C_SUCCESS
 421         The event layout shall be:
 422         event:       parm:
 423         mac[0]  =   mac[5];
 424         mac[1]  =   mac[4];
 425         mac[2]  =   event's sequence number, starting from 1 to parm's marc[3]
 426         mac[3]  =   mac[2];
 427         mac[4]  =   mac[1];
 428         mac[5]  =   mac[0];
 429         s0              =   swap16(s0) - event.mac[2];
 430         s1              =   s1 + event.mac[2];
 431         w0              =       swap32(w0);
 432         b0              =       b1
 433         s2              =       s0 + event.mac[2]
 434         b1              =       b0
 435         w1              =       swap32(w1) - event.mac[2];
 436
 437         parm->mac[3] is the total event counts that host requested.
 438
 439
 440         event will be the same with the cmd's param.
 441
 442 */
 443
 444 /* CMD param Formart for DRV INTERNAL CMD HDL*/
 445 struct drvint_cmd_parm {
 446         int i_cid; /*internal cmd id*/
 447         int sz; /* buf sz*/
 448         unsigned char *pbuf;
 449 };
 450
 451 /*------------------- Below are used for RF/BB tunning ---------------------*/
 452
 453 struct  setantenna_parm {
 454         u8      tx_antset;
 455         u8      rx_antset;
 456         u8      tx_antenna;
 457         u8      rx_antenna;
 458 };
 459
 460 struct  enrateadaptive_parm {
 461         u32     en;
 462 };
 463
 464 struct settxagctbl_parm {
 465         u32     txagc[MAX_RATES_LENGTH];
 466 };
 467
 468 struct gettxagctbl_parm {
 469         u32 rsvd;
 470 };
 471 struct gettxagctbl_rsp {
 472         u32     txagc[MAX_RATES_LENGTH];
 473 };
 474
 475 struct setagcctrl_parm {
 476         u32     agcctrl;        /* 0: pure hw, 1: fw */
 477 };
 478
 479 struct setssup_parm     {
 480         u32     ss_ForceUp[MAX_RATES_LENGTH];
 481 };
 482
 483 struct getssup_parm     {
 484         u32 rsvd;
 485 };
 486 struct getssup_rsp      {
 487         u8      ss_ForceUp[MAX_RATES_LENGTH];
 488 };
 489
 490 struct setssdlevel_parm {
 491         u8      ss_DLevel[MAX_RATES_LENGTH];
 492 };
 493
 494 struct getssdlevel_parm {
 495         u32 rsvd;
 496 };
 497 struct getssdlevel_rsp  {
 498         u8      ss_DLevel[MAX_RATES_LENGTH];
 499 };
 500
 501 struct setssulevel_parm {
 502         u8      ss_ULevel[MAX_RATES_LENGTH];
 503 };
 504
 505 struct getssulevel_parm {
 506         u32 rsvd;
 507 };
 508 struct getssulevel_rsp  {
 509         u8      ss_ULevel[MAX_RATES_LENGTH];
 510 };
 511
 512 struct  setcountjudge_parm {
 513         u8      count_judge[MAX_RATES_LENGTH];
 514 };
 515
 516 struct  getcountjudge_parm {
 517         u32 rsvd;
 518 };
 519
 520 struct  getcountjudge_rsp {
 521         u8      count_judge[MAX_RATES_LENGTH];
 522 };
 523
 524 struct setpwrmode_parm  {
 525         u8      mode;
 526         u8      flag_low_traffic_en;
 527         u8      flag_lpnav_en;
 528         u8      flag_rf_low_snr_en;
 529         u8      flag_dps_en; /* 1: dps, 0: 32k */
 530         u8      bcn_rx_en;
 531         u8      bcn_pass_cnt;     /* fw report one beacon information to
 532                                    * driver  when it receives bcn_pass_cnt
 533                                    *  beacons. */
 534         u8      bcn_to;           /* beacon TO (ms). ¡§=0¡¨ no limit.*/
 535         u16     bcn_itv;
 536         u8      app_itv; /* only for VOIP mode. */
 537         u8      awake_bcn_itv;
 538         u8      smart_ps;
 539         u8      bcn_pass_time;  /* unit: 100ms */
 540 };
 541
 542 struct setatim_parm {
 543         u8 op;   /*0: add, 1:del*/
 544         u8 txid; /* id of dest station.*/
 545 };
 546
 547 struct setratable_parm {
 548         u8 ss_ForceUp[NumRates];
 549         u8 ss_ULevel[NumRates];
 550         u8 ss_DLevel[NumRates];
 551         u8 count_judge[NumRates];
 552 };
 553
 554 struct getratable_parm {
 555         uint rsvd;
 556 };
 557 struct getratable_rsp {
 558         u8 ss_ForceUp[NumRates];
 559         u8 ss_ULevel[NumRates];
 560         u8 ss_DLevel[NumRates];
 561         u8 count_judge[NumRates];
 562 };
 563
 564 /*to get TX,RX retry count*/
 565 struct gettxretrycnt_parm{
 566         unsigned int rsvd;
 567 };
 568
 569 struct gettxretrycnt_rsp{
 570         unsigned long tx_retrycnt;
 571 };
 572
 573 struct getrxretrycnt_parm{
 574         unsigned int rsvd;
 575 };
 576
 577 struct getrxretrycnt_rsp{
 578         unsigned long rx_retrycnt;
 579 };
 580
 581 /*to get BCNOK,BCNERR count*/
 582 struct getbcnokcnt_parm{
 583         unsigned int rsvd;
 584 };
 585
 586 struct getbcnokcnt_rsp{
 587         unsigned long  bcnokcnt;
 588 };
 589
 590 struct getbcnerrcnt_parm{
 591         unsigned int rsvd;
 592 };
 593 struct getbcnerrcnt_rsp{
 594         unsigned long bcnerrcnt;
 595 };
 596
 597 /* to get current TX power level*/
 598 struct getcurtxpwrlevel_parm{
 599         unsigned int rsvd;
 600 };
 601
 602 struct getcurtxpwrlevel_rsp{
 603         unsigned short tx_power;
 604 };
 605
 606 /*dynamic on/off DIG*/
 607 struct setdig_parm{
 608         unsigned char dig_on;   /* 1:on , 0:off */
 609 };
 610
 611 /*dynamic on/off RA*/
 612 struct setra_parm{
 613         unsigned char ra_on;    /* 1:on , 0:off */
 614 };
 615
 616 struct setprobereqextraie_parm {
 617         unsigned char e_id;
 618         unsigned char ie_len;
 619         unsigned char ie[0];
 620 };
 621
 622 struct setassocreqextraie_parm {
 623         unsigned char e_id;
 624         unsigned char ie_len;
 625         unsigned char ie[0];
 626 };
 627
 628 struct setproberspextraie_parm {
 629         unsigned char e_id;
 630         unsigned char ie_len;
 631         unsigned char ie[0];
 632 };
 633
 634 struct setassocrspextraie_parm {
 635         unsigned char e_id;
 636         unsigned char ie_len;
 637         unsigned char ie[0];
 638 };
 639
 640 struct addBaReq_parm {
 641         unsigned int tid;
 642 };
 643
 644 /*H2C Handler index: 46 */
 645 struct SetChannel_parm {
 646         u32 curr_ch;
 647 };
 648
 649 /*H2C Handler index: 56 */
 650 struct PT_param {
 651         u8 PT_En;
 652 };
 653
 654 #define GEN_CMD_CODE(cmd)       cmd ## _CMD_
 655
 656 /*
 657  * Result:
 658  * 0x00: success
 659  * 0x01: success, and check Response.
 660  * 0x02: cmd ignored due to duplicated sequcne number
 661  * 0x03: cmd dropped due to invalid cmd code
 662  * 0x04: reserved.
 663  */
 664
 665 #define H2C_RSP_OFFSET                  512
 666 #define H2C_SUCCESS                     0x00
 667 #define H2C_SUCCESS_RSP                 0x01
 668 #define H2C_DUPLICATED                  0x02
 669 #define H2C_DROPPED                     0x03
 670 #define H2C_PARAMETERS_ERROR            0x04
 671 #define H2C_REJECTED                    0x05
 672 #define H2C_CMD_OVERFLOW                0x06
 673 #define H2C_RESERVED                    0x07
 674
 675 u8 r8712_setMacAddr_cmd(struct _adapter *padapter, u8 *mac_addr);
 676 u8 r8712_setassocsta_cmd(struct _adapter *padapter, u8 *mac_addr);
 677 u8 r8712_sitesurvey_cmd(struct _adapter *padapter,
 678                         struct ndis_802_11_ssid *pssid);
 679 u8 r8712_createbss_cmd(struct _adapter *padapter);
 680 u8 r8712_setstakey_cmd(struct _adapter *padapter, u8 *psta, u8 unicast_key);
 681 u8 r8712_joinbss_cmd(struct _adapter *padapter,
 682                      struct wlan_network *pnetwork);
 683 u8 r8712_disassoc_cmd(struct _adapter *padapter);
 684 u8 r8712_setopmode_cmd(struct _adapter *padapter,
 685                  enum NDIS_802_11_NETWORK_INFRASTRUCTURE networktype);
 686 u8 r8712_setdatarate_cmd(struct _adapter *padapter, u8 *rateset);
 687 u8 r8712_setbasicrate_cmd(struct _adapter *padapter, u8 *rateset);
 688 u8 r8712_getrfreg_cmd(struct _adapter *padapter, u8 offset, u8 * pval);
 689 u8 r8712_setrfintfs_cmd(struct _adapter *padapter, u8 mode);
 690 u8 r8712_setrfreg_cmd(struct _adapter  *padapter, u8 offset, u32 val);
 691 u8 r8712_setrttbl_cmd(struct _adapter  *padapter,
 692                       struct setratable_parm *prate_table);
 693 u8 r8712_setptm_cmd(struct _adapter *padapter, u8 type);
 694 u8 r8712_addbareq_cmd(struct _adapter *padapter, u8 tid);
 695 u8 r8712_wdg_wk_cmd(struct _adapter *padapter);
 696 void r8712_survey_cmd_callback(struct _adapter  *padapter,
 697                                struct cmd_obj *pcmd);
 698 void r8712_disassoc_cmd_callback(struct _adapter  *padapter,
 699                                  struct cmd_obj *pcmd);
 700 void r8712_joinbss_cmd_callback(struct _adapter  *padapter,
 701                                 struct cmd_obj *pcmd);
 702 void r8712_createbss_cmd_callback(struct _adapter *padapter,
 703                                   struct cmd_obj *pcmd);
 704 void r8712_getbbrfreg_cmdrsp_callback(struct _adapter *padapter,
 705                                       struct cmd_obj *pcmd);
 706 void r8712_setstaKey_cmdrsp_callback(struct _adapter  *padapter,
 707                                      struct cmd_obj *pcmd);
 708 void r8712_setassocsta_cmdrsp_callback(struct _adapter  *padapter,
 709                                        struct cmd_obj *pcmd);
 710
 711 struct _cmd_callback {
 712         u32     cmd_code;
 713         void (*callback)(struct _adapter  *padapter, struct cmd_obj *cmd);
 714 };
 715
 716 #include "rtl8712_cmd.h"
 717
 718 #endif /* _CMD_H_ */
 719