target/linux/brcm-2.4/files/arch/mips/bcm947xx/include/sbutils.h

   1 /*
   2  * Misc utility routines for accessing chip-specific features
   3  * of Broadcom HNBU SiliconBackplane-based chips.
   4  *
   5  * Copyright 2007, Broadcom Corporation
   6  * All Rights Reserved.
   7  *
   8  * THIS SOFTWARE IS OFFERED "AS IS", AND BROADCOM GRANTS NO WARRANTIES OF ANY
   9  * KIND, EXPRESS OR IMPLIED, BY STATUTE, COMMUNICATION OR OTHERWISE. BROADCOM
  10  * SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
  11  * FOR A SPECIFIC PURPOSE OR NONINFRINGEMENT CONCERNING THIS SOFTWARE.
  12  *
  13  * $Id$
  14  */
  15
  16 #ifndef _sbutils_h_
  17 #define _sbutils_h_
  18
  19 /*
  20  * Data structure to export all chip specific common variables
  21  * public (read-only) portion of sbutils handle returned by
  22  * sb_attach()/sb_kattach()
  23 */
  24
  25 struct sb_pub {
  26
  27         uint    bustype;                /* SB_BUS, PCI_BUS  */
  28         uint    buscoretype;            /* SB_PCI, SB_PCMCIA, SB_PCIE */
  29         uint    buscorerev;             /* buscore rev */
  30         uint    buscoreidx;             /* buscore index */
  31         int     ccrev;                  /* chip common core rev */
  32         uint32  cccaps;                 /* chip common capabilities */
  33         int     pmurev;                 /* pmu core rev */
  34         uint32  pmucaps;                /* pmu capabilities */
  35         uint    boardtype;              /* board type */
  36         uint    boardvendor;            /* board vendor */
  37         uint    boardflags;             /* board flags */
  38         uint    chip;                   /* chip number */
  39         uint    chiprev;                /* chip revision */
  40         uint    chippkg;                /* chip package option */
  41         uint32  chipst;                 /* chip status */
  42         uint    sonicsrev;              /* sonics backplane rev */
  43         bool    pr42780;                /* whether PCIE 42780 WAR applies to this chip */
  44         bool    pr32414;                /* whether 432414 WAR applis to the chip */
  45 };
  46
  47 typedef const struct sb_pub sb_t;
  48
  49 /*
  50  * Many of the routines below take an 'sbh' handle as their first arg.
  51  * Allocate this by calling sb_attach().  Free it by calling sb_detach().
  52  * At any one time, the sbh is logically focused on one particular sb core
  53  * (the "current core").
  54  * Use sb_setcore() or sb_setcoreidx() to change the association to another core.
  55  */
  56
  57 #define SB_OSH          NULL    /* Use for sb_kattach when no osh is available */
  58
  59 /* exported externs */
  60 extern sb_t *sb_attach(uint pcidev, osl_t *osh, void *regs, uint bustype,
  61                        void *sdh, char **vars, uint *varsz);
  62 extern sb_t *sb_kattach(osl_t *osh);
  63 extern void sb_detach(sb_t *sbh);
  64 extern uint sb_chip(sb_t *sbh);
  65 extern uint sb_chiprev(sb_t *sbh);
  66 extern uint sb_chipcrev(sb_t *sbh);
  67 extern uint sb_chippkg(sb_t *sbh);
  68 extern uint sb_pcirev(sb_t *sbh);
  69 extern bool sb_war16165(sb_t *sbh);
  70 extern uint sb_pcmciarev(sb_t *sbh);
  71 extern uint sb_boardvendor(sb_t *sbh);
  72 extern uint sb_boardtype(sb_t *sbh);
  73 extern uint sb_bus(sb_t *sbh);
  74 extern uint sb_buscoretype(sb_t *sbh);
  75 extern uint sb_buscorerev(sb_t *sbh);
  76 extern uint sb_corelist(sb_t *sbh, uint coreid[]);
  77 extern uint sb_coreid(sb_t *sbh);
  78 extern uint sb_flag(sb_t *sbh);
  79 extern uint sb_coreidx(sb_t *sbh);
  80 extern uint sb_coreunit(sb_t *sbh);
  81 extern uint sb_corevendor(sb_t *sbh);
  82 extern uint sb_corerev(sb_t *sbh);
  83 extern void *sb_osh(sb_t *sbh);
  84 extern void sb_setosh(sb_t *sbh, osl_t *osh);
  85 extern uint sb_corereg(sb_t *sbh, uint coreidx, uint regoff, uint mask, uint val);
  86 extern void *sb_coreregs(sb_t *sbh);
  87 extern uint32 sb_coreflags(sb_t *sbh, uint32 mask, uint32 val);
  88 extern void sb_coreflags_wo(sb_t *sbh, uint32 mask, uint32 val);
  89 extern uint32 sb_coreflagshi(sb_t *sbh, uint32 mask, uint32 val);
  90 extern bool sb_iscoreup(sb_t *sbh);
  91 extern uint sb_findcoreidx(sb_t *sbh, uint coreid, uint coreunit);
  92 extern void *sb_setcoreidx(sb_t *sbh, uint coreidx);
  93 extern void *sb_setcore(sb_t *sbh, uint coreid, uint coreunit);
  94 extern int sb_corebist(sb_t *sbh);
  95 extern void sb_commit(sb_t *sbh);
  96 extern uint32 sb_base(uint32 admatch);
  97 extern uint32 sb_size(uint32 admatch);
  98 extern void sb_core_reset(sb_t *sbh, uint32 bits, uint32 resetbits);
  99 extern void sb_core_tofixup(sb_t *sbh);
 100 extern void sb_core_disable(sb_t *sbh, uint32 bits);
 101 extern uint32 sb_clock_rate(uint32 pll_type, uint32 n, uint32 m);
 102 extern uint32 sb_clock(sb_t *sbh);
 103 extern uint32 sb_alp_clock(sb_t *sbh);
 104 extern void sb_pci_setup(sb_t *sbh, uint coremask);
 105 extern void sb_pcmcia_init(sb_t *sbh);
 106 extern void sb_watchdog(sb_t *sbh, uint ticks);
 107 extern void *sb_gpiosetcore(sb_t *sbh);
 108 extern uint32 sb_gpiocontrol(sb_t *sbh, uint32 mask, uint32 val, uint8 priority);
 109 extern uint32 sb_gpioouten(sb_t *sbh, uint32 mask, uint32 val, uint8 priority);
 110 extern uint32 sb_gpioout(sb_t *sbh, uint32 mask, uint32 val, uint8 priority);
 111 extern uint32 sb_gpioin(sb_t *sbh);
 112 extern uint32 sb_gpiointpolarity(sb_t *sbh, uint32 mask, uint32 val, uint8 priority);
 113 extern uint32 sb_gpiointmask(sb_t *sbh, uint32 mask, uint32 val, uint8 priority);
 114 extern uint32 sb_gpioled(sb_t *sbh, uint32 mask, uint32 val);
 115 extern uint32 sb_gpioreserve(sb_t *sbh, uint32 gpio_num, uint8 priority);
 116 extern uint32 sb_gpiorelease(sb_t *sbh, uint32 gpio_num, uint8 priority);
 117 extern uint32 sb_gpiopull(sb_t *sbh, bool updown, uint32 mask, uint32 val);
 118 extern uint32 sb_gpioevent(sb_t *sbh, uint regtype, uint32 mask, uint32 val);
 119 extern uint32 sb_gpio_int_enable(sb_t *sbh, bool enable);
 120
 121 /* GPIO event handlers */
 122 typedef void (*gpio_handler_t)(uint32 stat, void *arg);
 123
 124 extern void *sb_gpio_handler_register(sb_t *sbh, uint32 event,
 125         bool level, gpio_handler_t cb, void *arg);
 126 extern void sb_gpio_handler_unregister(sb_t *sbh, void* gpioh);
 127 extern void sb_gpio_handler_process(sb_t *sbh);
 128
 129 extern void sb_clkctl_init(sb_t *sbh);
 130 extern uint16 sb_clkctl_fast_pwrup_delay(sb_t *sbh);
 131 extern bool sb_clkctl_clk(sb_t *sbh, uint mode);
 132 extern int sb_clkctl_xtal(sb_t *sbh, uint what, bool on);
 133 extern void sb_register_intr_callback(sb_t *sbh, void *intrsoff_fn, void *intrsrestore_fn,
 134                                       void *intrsenabled_fn, void *intr_arg);
 135 extern void sb_deregister_intr_callback(sb_t *sbh);
 136 extern uint32 sb_set_initiator_to(sb_t *sbh, uint32 to, uint idx);
 137 extern uint16 sb_d11_devid(sb_t *sbh);
 138 extern int sb_corepciid(sb_t *sbh, uint func, uint16 *pcivendor, uint16 *pcidevice,
 139                         uint8 *pciclass, uint8 *pcisubclass, uint8 *pciprogif,
 140                         uint8 *pciheader);
 141 extern uint sb_pcie_readreg(void *sbh, void* arg1, uint offset);
 142 extern uint sb_pcie_writereg(sb_t *sbh, void *arg1,  uint offset, uint val);
 143 extern uint32 sb_gpiotimerval(sb_t *sbh, uint32 mask, uint32 val);
 144 extern bool sb_backplane64(sb_t *sbh);
 145 extern void sb_btcgpiowar(sb_t *sbh);
 146
 147
 148 #if defined(BCMDBG_ASSERT)
 149 extern bool sb_taclear(sb_t *sbh);
 150 #endif
 151
 152 #ifdef BCMDBG
 153 extern void sb_dump(sb_t *sbh, struct bcmstrbuf *b);
 154 extern void sb_dumpregs(sb_t *sbh, struct bcmstrbuf *b);
 155 extern void sb_view(sb_t *sbh);
 156 extern void sb_viewall(sb_t *sbh);
 157 extern void sb_clkctl_dump(sb_t *sbh, struct bcmstrbuf *b);
 158 extern uint8 sb_pcieL1plldown(sb_t *sbh);
 159 extern uint32 sb_pcielcreg(sb_t *sbh, uint32 mask, uint32 val);
 160 #endif
 161
 162 extern bool sb_deviceremoved(sb_t *sbh);
 163 extern uint32 sb_socram_size(sb_t *sbh);
 164
 165 /*
 166 * Build device path. Path size must be >= SB_DEVPATH_BUFSZ.
 167 * The returned path is NULL terminated and has trailing '/'.
 168 * Return 0 on success, nonzero otherwise.
 169 */
 170 extern int sb_devpath(sb_t *sbh, char *path, int size);
 171 /* Read variable with prepending the devpath to the name */
 172 extern char *sb_getdevpathvar(sb_t *sbh, const char *name);
 173 extern int sb_getdevpathintvar(sb_t *sbh, const char *name);
 174
 175 extern uint8 sb_pcieclkreq(sb_t *sbh, uint32 mask, uint32 val);
 176 extern void sb_war42780_clkreq(sb_t *sbh, bool clkreq);
 177 extern void sb_pci_sleep(sb_t *sbh);
 178 extern void sb_pci_down(sb_t *sbh);
 179 extern void sb_pci_up(sb_t *sbh);
 180
 181 /* Wake-on-wireless-LAN (WOWL) */
 182 extern bool sb_pci_pmecap(sb_t *sbh);
 183 extern bool sb_pci_pmeclr(sb_t *sbh);
 184 extern void sb_pci_pmeen(sb_t *sbh);
 185
 186 /* clkctl xtal what flags */
 187 #define XTAL                    0x1             /* primary crystal oscillator (2050) */
 188 #define PLL                     0x2             /* main chip pll */
 189
 190 /* clkctl clk mode */
 191 #define CLK_FAST                0               /* force fast (pll) clock */
 192 #define CLK_DYNAMIC             2               /* enable dynamic clock control */
 193
 194
 195 /* GPIO usage priorities */
 196 #define GPIO_DRV_PRIORITY       0               /* Driver */
 197 #define GPIO_APP_PRIORITY       1               /* Application */
 198 #define GPIO_HI_PRIORITY        2               /* Highest priority. Ignore GPIO reservation */
 199
 200 /* GPIO pull up/down */
 201 #define GPIO_PULLUP             0
 202 #define GPIO_PULLDN             1
 203
 204 /* GPIO event regtype */
 205 #define GPIO_REGEVT                     0       /* GPIO register event */
 206 #define GPIO_REGEVT_INTMSK              1       /* GPIO register event int mask */
 207 #define GPIO_REGEVT_INTPOL              2       /* GPIO register event int polarity */
 208
 209 /* device path */
 210 #define SB_DEVPATH_BUFSZ        16              /* min buffer size in bytes */
 211
 212 #endif  /* _sbutils_h_ */