On Wednesday 24 October 2007 23:11:41 you wrote:
> On 10/24/07, bruno randolf <[EMAIL PROTECTED]> wrote:
> > ok, i put up the register list on
> > http://madwifi.org/wiki/DevDocs/AtherosRegisters.
>
> This is nice, however I was planning on migrating registers to
> Kerneldoc format, then we can add documentation to each register in
> the source and also as a bonus get nice kernel docs we can put online
> automatically. I will move a few registers to this in my next patch
> series.
well, thats fine with me as long as i can parse the output in perl - and i
guess with automatically generated docs that should not be too difficult.
i added a few options to the ath-reg-decode.pl tool
--chip specify the chipset (5212 (default), 5211, 5210)
--regfile the file with the register list, will be auto fetched from
the wiki if not available
--dump dump all contents of file, i.e. all registers
--out output format:
for dumps:
* "wiki" table
* "define": #defines
* "case" (for switch case in c code)
for trace log files
* default:
* initval: for generating initval lists
--lookup lookup only one register
default output looks like this:
R: 0x9858 = 0x7ec00d2e - AR5K_PHY_SIG \
.111 111. 11.. .... .... 11.1 ..1. 111.
--out initval looks like this:
{ AR5K_PHY_PCDAC_TXPOWER(2), 0x0fff0fff },
{ AR5K_PHY_PCDAC_TXPOWER(3), 0x11ff11ff },
...should come in handy when generating the initval lists, instead of manual
copy & paste
--dump by default is just a whitespace separated list:
0x9c1c AR5K_PHY_CURRENT_RSSI [5111+] PHY current...
--dump --out case
case 0x9c10: return "AR5K_PHY_IQRES_CAL_PWR_I"; break;
--dump --out define
#define AR5K_PHY_IQRES_CAL_CORR 0x9c18 /* [5111+] PHY timing IQ
calibration result register: I/Q Correlation */
o.k. i think i've overdone it a bit, but adding new output formats is real
easy. :)
bruno
On Wednesday 24 October 2007 23:11:41 Luis R. Rodriguez wrote:
> On 10/24/07, bruno randolf <[EMAIL PROTECTED]> wrote:
> > ok, i put up the register list on
> > http://madwifi.org/wiki/DevDocs/AtherosRegisters.
>
> This is nice, however I was planning on migrating registers to
> Kerneldoc format, then we can add documentation to each register in
> the source and also as a bonus get nice kernel docs we can put online
> automatically. I will move a few registers to this in my next patch
> series.
>
> > the conversion tool (http://br1.einfach.org/ath/ath-reg-decode.pl) will
> > now download the list from the wiki and output lines like this when
> > applied to a ath_hal.log (all on one line of course)
> >
> > W: 0x105c = 0x00203c07 - AR5K_QUEUE_DFS_LOCAL_IFS(7) \
> > .... .... ..1. .... ..11 11.. .... .111
>
> Very cool!
>
> Luis
_______________________________________________
ath5k-devel mailing list
ath5k-devel@lists.ath5k.org
https://lists.ath5k.org/mailman/listinfo/ath5k-devel
