2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2007-2009 Sam Leffler, Errno Consulting
5 * Copyright (c) 2007-2009 Marvell Semiconductor, Inc.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer,
13 * without modification.
14 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
15 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
16 * redistribution must be conditioned upon including a substantially
17 * similar Disclaimer requirement for further binary redistribution.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
23 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
24 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
25 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
28 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
30 * THE POSSIBILITY OF SUCH DAMAGES.
38 * Diagnostic interface. This is an open-ended interface that
39 * is opaque to applications. Diagnostic programs use this to
40 * retrieve internal data structures, etc. There is no guarantee
41 * that calling conventions for calls other than MWL_DIAG_REVS
42 * are stable between HAL releases; a diagnostic application must
43 * use the HAL revision information to deal with ABI/API differences.
45 * NB: do not renumber these, certain codes are publicly used.
48 MWL_DIAG_CMD_REVS = 0, /* MAC/PHY/Radio revs */
49 MWL_DIAG_CMD_REGS = 1, /* Registers */
50 MWL_DIAG_CMD_HOSTCMD = 2, /* issue arbitrary cmd */
51 MWL_DIAG_CMD_FWLOAD = 3, /* load firmware */
55 * Device revision information.
58 uint16_t mh_devid; /* PCI device ID */
59 uint16_t mh_subvendorid; /* PCI subvendor ID */
60 uint16_t mh_macRev; /* MAC revision */
61 uint16_t mh_phyRev; /* PHY revision */
65 uint16_t start; /* first register */
66 uint16_t end; /* ending register or zero */
70 * Registers are mapped into virtual banks; the hal converts
71 * r/w operations through the diag api to host cmds as required.
73 * NB: register offsets are 16-bits and we need to avoid real
74 * register mappings in BAR1.
76 #define MWL_DIAG_BASE_MAC 0xa000
77 #define MWL_DIAG_ISMAC(r) \
78 (MWL_DIAG_BASE_MAC <= (r) && (r) < (MWL_DIAG_BASE_MAC+0x1000))
79 #define MWL_DIAG_BASE_BB 0xe000
80 #define MWL_DIAG_ISBB(r) \
81 (MWL_DIAG_BASE_BB <= (r) && (r) < (MWL_DIAG_BASE_BB+0x1000))
82 #define MWL_DIAG_BASE_RF 0xf000
83 #define MWL_DIAG_ISRF(r) \
84 (MWL_DIAG_BASE_RF <= (r) && (r) < (MWL_DIAG_BASE_RF+0x1000))
90 uint32_t opmode; /* operating mode */
91 uint32_t signature; /* f/w ready signature */
92 char name[1]; /* variable length pathname */
96 char md_name[IFNAMSIZ]; /* if name, e.g. "mv0" */
98 #define MWL_DIAG_DYN 0x8000 /* allocate buffer in caller */
99 #define MWL_DIAG_IN 0x4000 /* copy in parameters */
100 #define MWL_DIAG_OUT 0x0000 /* copy out results (always) */
101 #define MWL_DIAG_ID 0x0fff
102 uint16_t md_in_size; /* pack to fit, yech */
108 #define SIOCGMVDIAG _IOWR('i', 138, struct mwl_diag)
109 #define SIOCGMVRESET _IOW('i', 139, struct mwl_diag)
110 #endif /* _MWL_DIAG_H_ */