1/*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 2002-2008 Sam Leffler, Errno Consulting 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer, 12 * without modification. 13 * 2. Redistributions in binary form must reproduce at minimum a disclaimer 14 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any 15 * redistribution must be conditioned upon including a substantially 16 * similar Disclaimer requirement for further binary redistribution. 17 * 18 * NO WARRANTY 19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 21 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY 22 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 23 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, 24 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 27 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29 * THE POSSIBILITY OF SUCH DAMAGES. 30 * 31 * $FreeBSD: releng/12.0/sys/dev/ath/ah_osdep.c 326255 2017-11-27 14:52:40Z pfg $ 32 */ 33#include "opt_ah.h" 34 35#include <sys/param.h> 36#include <sys/systm.h> 37#include <sys/kernel.h> 38#include <sys/module.h> 39#include <sys/sysctl.h> 40#include <sys/bus.h> 41#include <sys/malloc.h> 42#include <sys/proc.h> 43#include <sys/pcpu.h> 44#include <sys/lock.h> 45#include <sys/mutex.h> 46#include <sys/conf.h> 47 48#include <machine/stdarg.h> 49 50#include <net/ethernet.h> /* XXX for ether_sprintf */ 51 52#include <dev/ath/ath_hal/ah.h> 53#include <dev/ath/ath_hal/ah_debug.h> 54 55/* 56 * WiSoC boards overload the bus tag with information about the 57 * board layout. We must extract the bus space tag from that 58 * indirect structure. For everyone else the tag is passed in 59 * directly. 60 * XXX cache indirect ref privately 61 */ 62#ifdef AH_SUPPORT_AR5312 63#define BUSTAG(ah) \ 64 ((bus_space_tag_t) ((struct ar531x_config *)((ah)->ah_st))->tag) 65#else 66#define BUSTAG(ah) ((ah)->ah_st) 67#endif 68 69/* 70 * This lock is used to seralise register access for chips which have 71 * problems w/ SMP CPUs issuing concurrent PCI transactions. 72 * 73 * XXX This is a global lock for now; it should be pushed to 74 * a per-device lock in some platform-independent fashion. 75 */ 76struct mtx ah_regser_mtx; 77MTX_SYSINIT(ah_regser, &ah_regser_mtx, "Atheros register access mutex", 78 MTX_SPIN); 79 80extern void ath_hal_printf(struct ath_hal *, const char*, ...) 81 __printflike(2,3); 82extern void ath_hal_vprintf(struct ath_hal *, const char*, __va_list) 83 __printflike(2, 0); 84extern const char* ath_hal_ether_sprintf(const u_int8_t *mac); 85extern void *ath_hal_malloc(size_t); 86extern void ath_hal_free(void *); 87#ifdef AH_ASSERT 88extern void ath_hal_assert_failed(const char* filename, 89 int lineno, const char* msg); 90#endif 91#ifdef AH_DEBUG 92extern void DO_HALDEBUG(struct ath_hal *ah, u_int mask, const char* fmt, ...); 93#endif /* AH_DEBUG */ 94 95/* NB: put this here instead of the driver to avoid circular references */ 96SYSCTL_NODE(_hw, OID_AUTO, ath, CTLFLAG_RD | CTLFLAG_MPSAFE, 0, 97 "Atheros driver parameters"); 98static SYSCTL_NODE(_hw_ath, OID_AUTO, hal, CTLFLAG_RD | CTLFLAG_MPSAFE, 0, 99 "Atheros HAL parameters"); 100 101#ifdef AH_DEBUG 102int ath_hal_debug = 0; 103SYSCTL_INT(_hw_ath_hal, OID_AUTO, debug, CTLFLAG_RWTUN, &ath_hal_debug, 104 0, "Atheros HAL debugging printfs"); 105#endif /* AH_DEBUG */ 106 107static MALLOC_DEFINE(M_ATH_HAL, "ath_hal", "ath hal data"); 108 109void* 110ath_hal_malloc(size_t size) 111{ 112 return malloc(size, M_ATH_HAL, M_NOWAIT | M_ZERO); 113} 114 115void 116ath_hal_free(void* p) 117{ 118 free(p, M_ATH_HAL); 119} 120 121void 122ath_hal_vprintf(struct ath_hal *ah, const char* fmt, va_list ap) 123{ 124 vprintf(fmt, ap); 125} 126 127void 128ath_hal_printf(struct ath_hal *ah, const char* fmt, ...) 129{ 130 va_list ap; 131 va_start(ap, fmt); 132 ath_hal_vprintf(ah, fmt, ap); 133 va_end(ap); 134} 135 136const char* 137ath_hal_ether_sprintf(const u_int8_t *mac) 138{ 139 return ether_sprintf(mac); 140} 141 142#ifdef AH_DEBUG 143 144/* 145 * XXX This is highly relevant only for the AR5416 and later 146 * PCI/PCIe NICs. It'll need adjustment for other hardware 147 * variations. 148 */ 149static int 150ath_hal_reg_whilst_asleep(struct ath_hal *ah, uint32_t reg) 151{ 152 153 if (reg >= 0x4000 && reg < 0x5000) 154 return (1); 155 if (reg >= 0x6000 && reg < 0x7000) 156 return (1); 157 if (reg >= 0x7000 && reg < 0x8000) 158 return (1); 159 return (0); 160} 161 162void 163DO_HALDEBUG(struct ath_hal *ah, u_int mask, const char* fmt, ...) 164{ 165 if ((mask == HAL_DEBUG_UNMASKABLE) || 166 (ah != NULL && ah->ah_config.ah_debug & mask) || 167 (ath_hal_debug & mask)) { 168 __va_list ap; 169 va_start(ap, fmt); 170 ath_hal_vprintf(ah, fmt, ap); 171 va_end(ap); 172 } 173} 174#undef HAL_DEBUG_UNMASKABLE 175#endif /* AH_DEBUG */ 176 177#ifdef AH_DEBUG_ALQ 178/* 179 * ALQ register tracing support. 180 * 181 * Setting hw.ath.hal.alq=1 enables tracing of all register reads and 182 * writes to the file /tmp/ath_hal.log. The file format is a simple 183 * fixed-size array of records. When done logging set hw.ath.hal.alq=0 184 * and then decode the file with the arcode program (that is part of the 185 * HAL). If you start+stop tracing the data will be appended to an 186 * existing file. 187 * 188 * NB: doesn't handle multiple devices properly; only one DEVICE record 189 * is emitted and the different devices are not identified. 190 */ 191#include <sys/alq.h> 192#include <sys/pcpu.h> 193#include <dev/ath/ath_hal/ah_decode.h> 194 195static struct alq *ath_hal_alq; 196static int ath_hal_alq_emitdev; /* need to emit DEVICE record */ 197static u_int ath_hal_alq_lost; /* count of lost records */ 198static char ath_hal_logfile[MAXPATHLEN] = "/tmp/ath_hal.log"; 199 200SYSCTL_STRING(_hw_ath_hal, OID_AUTO, alq_logfile, CTLFLAG_RW, 201 &ath_hal_logfile, sizeof(kernelname), "Name of ALQ logfile"); 202 203static u_int ath_hal_alq_qsize = 64*1024; 204 205static int 206ath_hal_setlogging(int enable) 207{ 208 int error; 209 210 if (enable) { 211 error = alq_open(&ath_hal_alq, ath_hal_logfile, 212 curthread->td_ucred, ALQ_DEFAULT_CMODE, 213 sizeof (struct athregrec), ath_hal_alq_qsize); 214 ath_hal_alq_lost = 0; 215 ath_hal_alq_emitdev = 1; 216 printf("ath_hal: logging to %s enabled\n", 217 ath_hal_logfile); 218 } else { 219 if (ath_hal_alq) 220 alq_close(ath_hal_alq); 221 ath_hal_alq = NULL; 222 printf("ath_hal: logging disabled\n"); 223 error = 0; 224 } 225 return (error); 226} 227 228static int 229sysctl_hw_ath_hal_log(SYSCTL_HANDLER_ARGS) 230{ 231 int error, enable; 232 233 enable = (ath_hal_alq != NULL); 234 error = sysctl_handle_int(oidp, &enable, 0, req); 235 if (error || !req->newptr) 236 return (error); 237 else 238 return (ath_hal_setlogging(enable)); 239} 240SYSCTL_PROC(_hw_ath_hal, OID_AUTO, alq, 241 CTLTYPE_INT | CTLFLAG_RW | CTLFLAG_MPSAFE, 242 0, 0, sysctl_hw_ath_hal_log, "I", 243 "Enable HAL register logging"); 244SYSCTL_INT(_hw_ath_hal, OID_AUTO, alq_size, CTLFLAG_RW, 245 &ath_hal_alq_qsize, 0, "In-memory log size (#records)"); 246SYSCTL_INT(_hw_ath_hal, OID_AUTO, alq_lost, CTLFLAG_RW, 247 &ath_hal_alq_lost, 0, "Register operations not logged"); 248 249static struct ale * 250ath_hal_alq_get(struct ath_hal *ah) 251{ 252 struct ale *ale; 253 254 if (ath_hal_alq_emitdev) { 255 ale = alq_get(ath_hal_alq, ALQ_NOWAIT); 256 if (ale) { 257 struct athregrec *r = 258 (struct athregrec *) ale->ae_data; 259 r->op = OP_DEVICE; 260 r->reg = 0; 261 r->val = ah->ah_devid; 262 alq_post(ath_hal_alq, ale); 263 ath_hal_alq_emitdev = 0; 264 } else 265 ath_hal_alq_lost++; 266 } 267 ale = alq_get(ath_hal_alq, ALQ_NOWAIT); 268 if (!ale) 269 ath_hal_alq_lost++; 270 return ale; 271} 272 273void 274ath_hal_reg_write(struct ath_hal *ah, u_int32_t reg, u_int32_t val) 275{ 276 bus_space_tag_t tag = BUSTAG(ah); 277 bus_space_handle_t h = ah->ah_sh; 278 279#ifdef AH_DEBUG 280 /* Debug - complain if we haven't fully waken things up */ 281 if (! ath_hal_reg_whilst_asleep(ah, reg) && 282 ah->ah_powerMode != HAL_PM_AWAKE) { 283 ath_hal_printf(ah, "%s: reg=0x%08x, val=0x%08x, pm=%d\n", 284 __func__, reg, val, ah->ah_powerMode); 285 } 286#endif 287 288 if (ath_hal_alq) { 289 struct ale *ale = ath_hal_alq_get(ah); 290 if (ale) { 291 struct athregrec *r = (struct athregrec *) ale->ae_data; 292 r->threadid = curthread->td_tid; 293 r->op = OP_WRITE; 294 r->reg = reg; 295 r->val = val; 296 alq_post(ath_hal_alq, ale); 297 } 298 } 299 if (ah->ah_config.ah_serialise_reg_war) 300 mtx_lock_spin(&ah_regser_mtx); 301 bus_space_write_4(tag, h, reg, val); 302 OS_BUS_BARRIER_REG(ah, reg, OS_BUS_BARRIER_WRITE); 303 if (ah->ah_config.ah_serialise_reg_war) 304 mtx_unlock_spin(&ah_regser_mtx); 305} 306 307u_int32_t 308ath_hal_reg_read(struct ath_hal *ah, u_int32_t reg) 309{ 310 bus_space_tag_t tag = BUSTAG(ah); 311 bus_space_handle_t h = ah->ah_sh; 312 u_int32_t val; 313 314#ifdef AH_DEBUG 315 /* Debug - complain if we haven't fully waken things up */ 316 if (! ath_hal_reg_whilst_asleep(ah, reg) && 317 ah->ah_powerMode != HAL_PM_AWAKE) { 318 ath_hal_printf(ah, "%s: reg=0x%08x, pm=%d\n", 319 __func__, reg, ah->ah_powerMode); 320 } 321#endif 322 323 if (ah->ah_config.ah_serialise_reg_war) 324 mtx_lock_spin(&ah_regser_mtx); 325 OS_BUS_BARRIER_REG(ah, reg, OS_BUS_BARRIER_READ); 326 val = bus_space_read_4(tag, h, reg); 327 if (ah->ah_config.ah_serialise_reg_war) 328 mtx_unlock_spin(&ah_regser_mtx); 329 if (ath_hal_alq) { 330 struct ale *ale = ath_hal_alq_get(ah); 331 if (ale) { 332 struct athregrec *r = (struct athregrec *) ale->ae_data; 333 r->threadid = curthread->td_tid; 334 r->op = OP_READ; 335 r->reg = reg; 336 r->val = val; 337 alq_post(ath_hal_alq, ale); 338 } 339 } 340 return val; 341} 342 343void 344OS_MARK(struct ath_hal *ah, u_int id, u_int32_t v) 345{ 346 if (ath_hal_alq) { 347 struct ale *ale = ath_hal_alq_get(ah); 348 if (ale) { 349 struct athregrec *r = (struct athregrec *) ale->ae_data; 350 r->threadid = curthread->td_tid; 351 r->op = OP_MARK; 352 r->reg = id; 353 r->val = v; 354 alq_post(ath_hal_alq, ale); 355 } 356 } 357} 358#else /* AH_DEBUG_ALQ */ 359 360/* 361 * Memory-mapped device register read/write. These are here 362 * as routines when debugging support is enabled and/or when 363 * explicitly configured to use function calls. The latter is 364 * for architectures that might need to do something before 365 * referencing memory (e.g. remap an i/o window). 366 * 367 * NB: see the comments in ah_osdep.h about byte-swapping register 368 * reads and writes to understand what's going on below. 369 */ 370 371void 372ath_hal_reg_write(struct ath_hal *ah, u_int32_t reg, u_int32_t val) 373{ 374 bus_space_tag_t tag = BUSTAG(ah); 375 bus_space_handle_t h = ah->ah_sh; 376 377#ifdef AH_DEBUG 378 /* Debug - complain if we haven't fully waken things up */ 379 if (! ath_hal_reg_whilst_asleep(ah, reg) && 380 ah->ah_powerMode != HAL_PM_AWAKE) { 381 ath_hal_printf(ah, "%s: reg=0x%08x, val=0x%08x, pm=%d\n", 382 __func__, reg, val, ah->ah_powerMode); 383 } 384#endif 385 386 if (ah->ah_config.ah_serialise_reg_war) 387 mtx_lock_spin(&ah_regser_mtx); 388 bus_space_write_4(tag, h, reg, val); 389 OS_BUS_BARRIER_REG(ah, reg, OS_BUS_BARRIER_WRITE); 390 if (ah->ah_config.ah_serialise_reg_war) 391 mtx_unlock_spin(&ah_regser_mtx); 392} 393 394u_int32_t 395ath_hal_reg_read(struct ath_hal *ah, u_int32_t reg) 396{ 397 bus_space_tag_t tag = BUSTAG(ah); 398 bus_space_handle_t h = ah->ah_sh; 399 u_int32_t val; 400 401#ifdef AH_DEBUG 402 /* Debug - complain if we haven't fully waken things up */ 403 if (! ath_hal_reg_whilst_asleep(ah, reg) && 404 ah->ah_powerMode != HAL_PM_AWAKE) { 405 ath_hal_printf(ah, "%s: reg=0x%08x, pm=%d\n", 406 __func__, reg, ah->ah_powerMode); 407 } 408#endif 409 410 if (ah->ah_config.ah_serialise_reg_war) 411 mtx_lock_spin(&ah_regser_mtx); 412 OS_BUS_BARRIER_REG(ah, reg, OS_BUS_BARRIER_READ); 413 val = bus_space_read_4(tag, h, reg); 414 if (ah->ah_config.ah_serialise_reg_war) 415 mtx_unlock_spin(&ah_regser_mtx); 416 return val; 417} 418#endif /* AH_DEBUG_ALQ */ 419 420#ifdef AH_ASSERT 421void 422ath_hal_assert_failed(const char* filename, int lineno, const char *msg) 423{ 424 printf("Atheros HAL assertion failure: %s: line %u: %s\n", 425 filename, lineno, msg); 426 panic("ath_hal_assert"); 427} 428#endif /* AH_ASSERT */ 429 430static int 431ath_hal_modevent(module_t mod __unused, int type, void *data __unused) 432{ 433 int error = 0; 434 435 switch (type) { 436 case MOD_LOAD: 437 printf("[ath_hal] loaded\n"); 438 break; 439 440 case MOD_UNLOAD: 441 printf("[ath_hal] unloaded\n"); 442 break; 443 444 case MOD_SHUTDOWN: 445 break; 446 447 default: 448 error = EOPNOTSUPP; 449 break; 450 } 451 return (error); 452} 453 454MODULE_VERSION(ath_hal, 1); 455#if defined(AH_DEBUG_ALQ) 456MODULE_DEPEND(ath_hal, alq, 1, 1, 1); 457#endif 458