1 /* from src/prism2/download/prism2dl.c
3 * utility for downloading prism2 images moved into kernelspace
5 * Copyright (C) 1999 AbsoluteValue Systems, Inc. All Rights Reserved.
6 * --------------------------------------------------------------------
10 * The contents of this file are subject to the Mozilla Public
11 * License Version 1.1 (the "License"); you may not use this file
12 * except in compliance with the License. You may obtain a copy of
13 * the License at http://www.mozilla.org/MPL/
15 * Software distributed under the License is distributed on an "AS
16 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
17 * implied. See the License for the specific language governing
18 * rights and limitations under the License.
20 * Alternatively, the contents of this file may be used under the
21 * terms of the GNU Public License version 2 (the "GPL"), in which
22 * case the provisions of the GPL are applicable instead of the
23 * above. If you wish to allow the use of your version of this file
24 * only under the terms of the GPL and not to allow others to use
25 * your version of this file under the MPL, indicate your decision
26 * by deleting the provisions above and replace them with the notice
27 * and other provisions required by the GPL. If you do not delete
28 * the provisions above, a recipient may use your version of this
29 * file under either the MPL or the GPL.
31 * --------------------------------------------------------------------
33 * Inquiries regarding the linux-wlan Open Source project can be
36 * AbsoluteValue Systems Inc.
38 * http://www.linux-wlan.com
40 * --------------------------------------------------------------------
42 * Portions of the development of this software were funded by
43 * Intersil Corporation as part of PRISM(R) chipset product development.
45 * --------------------------------------------------------------------
48 /*================================================================*/
50 #include <linux/ihex.h>
51 #include <linux/slab.h>
53 /*================================================================*/
56 #define PRISM2_USB_FWFILE "prism2_ru.fw"
57 MODULE_FIRMWARE(PRISM2_USB_FWFILE
);
59 #define S3DATA_MAX 5000
60 #define S3PLUG_MAX 200
64 #define S3ADDR_PLUG (0xff000000UL)
65 #define S3ADDR_CRC (0xff100000UL)
66 #define S3ADDR_INFO (0xff200000UL)
67 #define S3ADDR_START (0xff400000UL)
69 #define CHUNKS_MAX 100
71 #define WRITESIZE_MAX 4096
73 /*================================================================*/
76 typedef struct s3datarec
{
83 typedef struct s3plugrec
{
89 typedef struct s3crcrec
{
95 typedef struct s3inforec
{
99 hfa384x_compident_t version
;
100 hfa384x_caplevel_t compat
;
102 hfa384x_compident_t platform
;
107 u8 buf
[HFA384x_PDA_LEN_MAX
];
108 hfa384x_pdrec_t
*rec
[HFA384x_PDA_RECS_MAX
];
112 typedef struct imgchunk
{
113 u32 addr
; /* start address */
114 u32 len
; /* in bytes */
115 u16 crc
; /* CRC value (if it falls at a chunk boundary) */
119 /*================================================================*/
120 /* Local Static Definitions */
122 /*----------------------------------------------------------------*/
123 /* s-record image processing */
126 unsigned int ns3data
;
127 s3datarec_t s3data
[S3DATA_MAX
];
130 unsigned int ns3plug
;
131 s3plugrec_t s3plug
[S3PLUG_MAX
];
135 s3crcrec_t s3crc
[S3CRC_MAX
];
138 unsigned int ns3info
;
139 s3inforec_t s3info
[S3INFO_MAX
];
141 /* S7 record (there _better_ be only one) */
144 /* Load image chunks */
145 unsigned int nfchunks
;
146 imgchunk_t fchunk
[CHUNKS_MAX
];
148 /* Note that for the following pdrec_t arrays, the len and code */
149 /* fields are stored in HOST byte order. The mkpdrlist() function */
150 /* does the conversion. */
151 /*----------------------------------------------------------------*/
152 /* PDA, built from [card|newfile]+[addfile1+addfile2...] */
155 hfa384x_compident_t nicid
;
156 hfa384x_caplevel_t rfid
;
157 hfa384x_caplevel_t macid
;
158 hfa384x_caplevel_t priid
;
160 /*================================================================*/
161 /* Local Function Declarations */
163 static int prism2_fwapply(const struct ihex_binrec
*rfptr
,
164 wlandevice_t
*wlandev
);
166 static int read_fwfile(const struct ihex_binrec
*rfptr
);
168 static int mkimage(imgchunk_t
*clist
, unsigned int *ccnt
);
170 static int read_cardpda(pda_t
*pda
, wlandevice_t
*wlandev
);
172 static int mkpdrlist(pda_t
*pda
);
174 static int plugimage(imgchunk_t
*fchunk
, unsigned int nfchunks
,
175 s3plugrec_t
*s3plug
, unsigned int ns3plug
, pda_t
* pda
);
177 static int crcimage(imgchunk_t
*fchunk
, unsigned int nfchunks
,
178 s3crcrec_t
*s3crc
, unsigned int ns3crc
);
180 static int writeimage(wlandevice_t
*wlandev
, imgchunk_t
*fchunk
,
181 unsigned int nfchunks
);
182 static void free_chunks(imgchunk_t
*fchunk
, unsigned int *nfchunks
);
184 static void free_srecs(void);
186 static int validate_identity(void);
188 /*================================================================*/
189 /* Function Definitions */
191 /*----------------------------------------------------------------
194 * Try and get firmware into memory
197 * udev usb device structure
198 * wlandev wlan device structure
203 ----------------------------------------------------------------*/
204 int prism2_fwtry(struct usb_device
*udev
, wlandevice_t
*wlandev
)
206 const struct firmware
*fw_entry
= NULL
;
208 printk(KERN_INFO
"prism2_usb: Checking for firmware %s\n",
210 if (request_ihex_firmware(&fw_entry
, PRISM2_USB_FWFILE
, &udev
->dev
) != 0) {
212 "prism2_usb: Firmware not available, but not essential\n");
214 "prism2_usb: can continue to use card anyway.\n");
218 printk(KERN_INFO
"prism2_usb: %s will be processed, size %zu\n",
219 PRISM2_USB_FWFILE
, fw_entry
->size
);
220 prism2_fwapply((const struct ihex_binrec
*)fw_entry
->data
, wlandev
);
222 release_firmware(fw_entry
);
226 /*----------------------------------------------------------------
229 * Apply the firmware loaded into memory
232 * rfptr firmware image in kernel memory
238 ----------------------------------------------------------------*/
239 int prism2_fwapply(const struct ihex_binrec
*rfptr
, wlandevice_t
*wlandev
)
241 signed int result
= 0;
242 p80211msg_dot11req_mibget_t getmsg
;
246 /* Initialize the data structures */
248 memset(s3data
, 0, sizeof(s3data
));
250 memset(s3plug
, 0, sizeof(s3plug
));
252 memset(s3crc
, 0, sizeof(s3crc
));
254 memset(s3info
, 0, sizeof(s3info
));
258 memset(fchunk
, 0, sizeof(fchunk
));
259 memset(&nicid
, 0, sizeof(nicid
));
260 memset(&rfid
, 0, sizeof(rfid
));
261 memset(&macid
, 0, sizeof(macid
));
262 memset(&priid
, 0, sizeof(priid
));
264 /* clear the pda and add an initial END record */
265 memset(&pda
, 0, sizeof(pda
));
266 pda
.rec
[0] = (hfa384x_pdrec_t
*) pda
.buf
;
267 pda
.rec
[0]->len
= cpu_to_le16(2); /* len in words */
268 pda
.rec
[0]->code
= cpu_to_le16(HFA384x_PDR_END_OF_PDA
);
271 /*-----------------------------------------------------*/
272 /* Put card into fwload state */
273 prism2sta_ifstate(wlandev
, P80211ENUM_ifstate_fwload
);
275 /* Build the PDA we're going to use. */
276 if (read_cardpda(&pda
, wlandev
)) {
277 printk(KERN_ERR
"load_cardpda failed, exiting.\n");
281 /* read the card's PRI-SUP */
282 memset(&getmsg
, 0, sizeof(getmsg
));
283 getmsg
.msgcode
= DIDmsg_dot11req_mibget
;
284 getmsg
.msglen
= sizeof(getmsg
);
285 strcpy(getmsg
.devname
, wlandev
->name
);
287 getmsg
.mibattribute
.did
= DIDmsg_dot11req_mibget_mibattribute
;
288 getmsg
.mibattribute
.status
= P80211ENUM_msgitem_status_data_ok
;
289 getmsg
.resultcode
.did
= DIDmsg_dot11req_mibget_resultcode
;
290 getmsg
.resultcode
.status
= P80211ENUM_msgitem_status_no_value
;
292 item
= (p80211itemd_t
*) getmsg
.mibattribute
.data
;
293 item
->did
= DIDmib_p2_p2NIC_p2PRISupRange
;
294 item
->status
= P80211ENUM_msgitem_status_no_value
;
296 data
= (u32
*) item
->data
;
298 /* DIDmsg_dot11req_mibget */
299 prism2mgmt_mibset_mibget(wlandev
, &getmsg
);
300 if (getmsg
.resultcode
.data
!= P80211ENUM_resultcode_success
)
301 printk(KERN_ERR
"Couldn't fetch PRI-SUP info\n");
303 /* Already in host order */
304 priid
.role
= *data
++;
306 priid
.variant
= *data
++;
307 priid
.bottom
= *data
++;
310 /* Read the S3 file */
311 result
= read_fwfile(rfptr
);
313 printk(KERN_ERR
"Failed to read the data exiting.\n");
317 result
= validate_identity();
320 printk(KERN_ERR
"Incompatible firmware image.\n");
324 if (startaddr
== 0x00000000) {
325 printk(KERN_ERR
"Can't RAM download a Flash image!\n");
329 /* Make the image chunks */
330 result
= mkimage(fchunk
, &nfchunks
);
332 /* Do any plugging */
333 result
= plugimage(fchunk
, nfchunks
, s3plug
, ns3plug
, &pda
);
335 printk(KERN_ERR
"Failed to plug data.\n");
339 /* Insert any CRCs */
340 if (crcimage(fchunk
, nfchunks
, s3crc
, ns3crc
)) {
341 printk(KERN_ERR
"Failed to insert all CRCs\n");
345 /* Write the image */
346 result
= writeimage(wlandev
, fchunk
, nfchunks
);
348 printk(KERN_ERR
"Failed to ramwrite image data.\n");
352 /* clear any allocated memory */
353 free_chunks(fchunk
, &nfchunks
);
356 printk(KERN_INFO
"prism2_usb: firmware loading finished.\n");
361 /*----------------------------------------------------------------
364 * Adds a CRC16 in the two bytes prior to each block identified by
365 * an S3 CRC record. Currently, we don't actually do a CRC we just
366 * insert the value 0xC0DE in hfa384x order.
369 * fchunk Array of image chunks
370 * nfchunks Number of image chunks
371 * s3crc Array of crc records
372 * ns3crc Number of crc records
377 ----------------------------------------------------------------*/
378 int crcimage(imgchunk_t
*fchunk
, unsigned int nfchunks
, s3crcrec_t
*s3crc
,
391 for (i
= 0; i
< ns3crc
; i
++) {
392 if (!s3crc
[i
].dowrite
)
394 crcstart
= s3crc
[i
].addr
;
395 crcend
= s3crc
[i
].addr
+ s3crc
[i
].len
;
397 for (c
= 0; c
< nfchunks
; c
++) {
398 cstart
= fchunk
[c
].addr
;
399 cend
= fchunk
[c
].addr
+ fchunk
[c
].len
;
400 /* the line below does an address & len match search */
401 /* unfortunately, I've found that the len fields of */
402 /* some crc records don't match with the length of */
403 /* the actual data, so we're not checking right */
405 /* if ( crcstart-2 >= cstart && crcend <= cend ) break; */
407 /* note the -2 below, it's to make sure the chunk has */
408 /* space for the CRC value */
409 if (crcstart
- 2 >= cstart
&& crcstart
< cend
)
414 "Failed to find chunk for "
415 "crcrec[%d], addr=0x%06x len=%d , "
417 i
, s3crc
[i
].addr
, s3crc
[i
].len
);
422 pr_debug("Adding crc @ 0x%06x\n", s3crc
[i
].addr
- 2);
423 chunkoff
= crcstart
- cstart
- 2;
424 dest
= fchunk
[c
].data
+ chunkoff
;
432 /*----------------------------------------------------------------
435 * Clears the chunklist data structures in preparation for a new file.
442 ----------------------------------------------------------------*/
443 void free_chunks(imgchunk_t
*fchunk
, unsigned int *nfchunks
)
446 for (i
= 0; i
< *nfchunks
; i
++) {
447 if (fchunk
[i
].data
!= NULL
)
448 kfree(fchunk
[i
].data
);
451 memset(fchunk
, 0, sizeof(*fchunk
));
455 /*----------------------------------------------------------------
458 * Clears the srec data structures in preparation for a new file.
465 ----------------------------------------------------------------*/
466 void free_srecs(void)
469 memset(s3data
, 0, sizeof(s3data
));
471 memset(s3plug
, 0, sizeof(s3plug
));
473 memset(s3crc
, 0, sizeof(s3crc
));
475 memset(s3info
, 0, sizeof(s3info
));
479 /*----------------------------------------------------------------
482 * Scans the currently loaded set of S records for data residing
483 * in contiguous memory regions. Each contiguous region is then
484 * made into a 'chunk'. This function assumes that we're building
485 * a new chunk list. Assumes the s3data items are in sorted order.
491 * ~0 - failure (probably an errno)
492 ----------------------------------------------------------------*/
493 int mkimage(imgchunk_t
*clist
, unsigned int *ccnt
)
506 /* There may already be data in the chunklist */
509 /* Establish the location and size of each chunk */
510 for (i
= 0; i
< ns3data
; i
++) {
511 if (s3data
[i
].addr
== nextaddr
) {
512 /* existing chunk, grow it */
513 clist
[currchunk
].len
+= s3data
[i
].len
;
514 nextaddr
+= s3data
[i
].len
;
518 currchunk
= *ccnt
- 1;
519 clist
[currchunk
].addr
= s3data
[i
].addr
;
520 clist
[currchunk
].len
= s3data
[i
].len
;
521 nextaddr
= s3data
[i
].addr
+ s3data
[i
].len
;
522 /* Expand the chunk if there is a CRC record at */
523 /* their beginning bound */
524 for (j
= 0; j
< ns3crc
; j
++) {
525 if (s3crc
[j
].dowrite
&&
526 s3crc
[j
].addr
== clist
[currchunk
].addr
) {
527 clist
[currchunk
].addr
-= 2;
528 clist
[currchunk
].len
+= 2;
534 /* We're currently assuming there aren't any overlapping chunks */
535 /* if this proves false, we'll need to add code to coalesce. */
537 /* Allocate buffer space for chunks */
538 for (i
= 0; i
< *ccnt
; i
++) {
539 clist
[i
].data
= kzalloc(clist
[i
].len
, GFP_KERNEL
);
540 if (clist
[i
].data
== NULL
) {
542 "failed to allocate image space, exitting.\n");
545 pr_debug("chunk[%d]: addr=0x%06x len=%d\n",
546 i
, clist
[i
].addr
, clist
[i
].len
);
549 /* Copy srec data to chunks */
550 for (i
= 0; i
< ns3data
; i
++) {
551 s3start
= s3data
[i
].addr
;
552 s3end
= s3start
+ s3data
[i
].len
- 1;
553 for (j
= 0; j
< *ccnt
; j
++) {
554 cstart
= clist
[j
].addr
;
555 cend
= cstart
+ clist
[j
].len
- 1;
556 if (s3start
>= cstart
&& s3end
<= cend
)
559 if (((unsigned int)j
) >= (*ccnt
)) {
561 "s3rec(a=0x%06x,l=%d), no chunk match, exiting.\n",
562 s3start
, s3data
[i
].len
);
565 coffset
= s3start
- cstart
;
566 memcpy(clist
[j
].data
+ coffset
, s3data
[i
].data
, s3data
[i
].len
);
572 /*----------------------------------------------------------------
575 * Reads a raw PDA and builds an array of pdrec_t structures.
578 * pda buffer containing raw PDA bytes
579 * pdrec ptr to an array of pdrec_t's. Will be filled on exit.
580 * nrec ptr to a variable that will contain the count of PDRs
584 * ~0 - failure (probably an errno)
585 ----------------------------------------------------------------*/
586 int mkpdrlist(pda_t
*pda
)
589 u16
*pda16
= (u16
*) pda
->buf
;
590 int curroff
; /* in 'words' */
594 while (curroff
< (HFA384x_PDA_LEN_MAX
/ 2) &&
595 le16_to_cpu(pda16
[curroff
+ 1]) != HFA384x_PDR_END_OF_PDA
) {
596 pda
->rec
[pda
->nrec
] = (hfa384x_pdrec_t
*) &(pda16
[curroff
]);
598 if (le16_to_cpu(pda
->rec
[pda
->nrec
]->code
) == HFA384x_PDR_NICID
) {
599 memcpy(&nicid
, &pda
->rec
[pda
->nrec
]->data
.nicid
,
601 nicid
.id
= le16_to_cpu(nicid
.id
);
602 nicid
.variant
= le16_to_cpu(nicid
.variant
);
603 nicid
.major
= le16_to_cpu(nicid
.major
);
604 nicid
.minor
= le16_to_cpu(nicid
.minor
);
606 if (le16_to_cpu(pda
->rec
[pda
->nrec
]->code
) ==
607 HFA384x_PDR_MFISUPRANGE
) {
608 memcpy(&rfid
, &pda
->rec
[pda
->nrec
]->data
.mfisuprange
,
610 rfid
.id
= le16_to_cpu(rfid
.id
);
611 rfid
.variant
= le16_to_cpu(rfid
.variant
);
612 rfid
.bottom
= le16_to_cpu(rfid
.bottom
);
613 rfid
.top
= le16_to_cpu(rfid
.top
);
615 if (le16_to_cpu(pda
->rec
[pda
->nrec
]->code
) ==
616 HFA384x_PDR_CFISUPRANGE
) {
617 memcpy(&macid
, &pda
->rec
[pda
->nrec
]->data
.cfisuprange
,
619 macid
.id
= le16_to_cpu(macid
.id
);
620 macid
.variant
= le16_to_cpu(macid
.variant
);
621 macid
.bottom
= le16_to_cpu(macid
.bottom
);
622 macid
.top
= le16_to_cpu(macid
.top
);
626 curroff
+= le16_to_cpu(pda16
[curroff
]) + 1;
629 if (curroff
>= (HFA384x_PDA_LEN_MAX
/ 2)) {
631 "no end record found or invalid lengths in "
632 "PDR data, exiting. %x %d\n", curroff
, pda
->nrec
);
635 if (le16_to_cpu(pda16
[curroff
+ 1]) == HFA384x_PDR_END_OF_PDA
) {
636 pda
->rec
[pda
->nrec
] = (hfa384x_pdrec_t
*) &(pda16
[curroff
]);
642 /*----------------------------------------------------------------
645 * Plugs the given image using the given plug records from the given
649 * fchunk Array of image chunks
650 * nfchunks Number of image chunks
651 * s3plug Array of plug records
652 * ns3plug Number of plug records
653 * pda Current pda data
658 ----------------------------------------------------------------*/
659 int plugimage(imgchunk_t
*fchunk
, unsigned int nfchunks
,
660 s3plugrec_t
*s3plug
, unsigned int ns3plug
, pda_t
* pda
)
663 int i
; /* plug index */
664 int j
; /* index of PDR or -1 if fname plug */
665 int c
; /* chunk index */
673 /* for each plug record */
674 for (i
= 0; i
< ns3plug
; i
++) {
675 pstart
= s3plug
[i
].addr
;
676 pend
= s3plug
[i
].addr
+ s3plug
[i
].len
;
677 /* find the matching PDR (or filename) */
678 if (s3plug
[i
].itemcode
!= 0xffffffffUL
) { /* not filename */
679 for (j
= 0; j
< pda
->nrec
; j
++) {
680 if (s3plug
[i
].itemcode
==
681 le16_to_cpu(pda
->rec
[j
]->code
))
687 if (j
>= pda
->nrec
&& j
!= -1) { /* if no matching PDR, fail */
689 "warning: Failed to find PDR for "
690 "plugrec 0x%04x.\n", s3plug
[i
].itemcode
);
691 continue; /* and move on to the next PDR */
693 /* MSM: They swear that unless it's the MAC address,
694 * the serial number, or the TX calibration records,
695 * then there's reasonable defaults in the f/w
696 * image. Therefore, missing PDRs in the card
697 * should only be a warning, not fatal.
698 * TODO: add fatals for the PDRs mentioned above.
705 /* Validate plug len against PDR len */
706 if (j
!= -1 && s3plug
[i
].len
< le16_to_cpu(pda
->rec
[j
]->len
)) {
708 "error: Plug vs. PDR len mismatch for "
709 "plugrec 0x%04x, abort plugging.\n",
715 /* Validate plug address against chunk data and identify chunk */
716 for (c
= 0; c
< nfchunks
; c
++) {
717 cstart
= fchunk
[c
].addr
;
718 cend
= fchunk
[c
].addr
+ fchunk
[c
].len
;
719 if (pstart
>= cstart
&& pend
<= cend
)
724 "error: Failed to find image chunk for "
725 "plugrec 0x%04x.\n", s3plug
[i
].itemcode
);
731 chunkoff
= pstart
- cstart
;
732 dest
= fchunk
[c
].data
+ chunkoff
;
733 pr_debug("Plugging item 0x%04x @ 0x%06x, len=%d, "
734 "cnum=%d coff=0x%06x\n",
735 s3plug
[i
].itemcode
, pstart
, s3plug
[i
].len
,
738 if (j
== -1) { /* plug the filename */
739 memset(dest
, 0, s3plug
[i
].len
);
740 strncpy(dest
, PRISM2_USB_FWFILE
, s3plug
[i
].len
- 1);
741 } else { /* plug a PDR */
742 memcpy(dest
, &(pda
->rec
[j
]->data
), s3plug
[i
].len
);
749 /*----------------------------------------------------------------
752 * Sends the command for the driver to read the pda from the card
753 * named in the device variable. Upon success, the card pda is
754 * stored in the "cardpda" variables. Note that the pda structure
755 * is considered 'well formed' after this function. That means
756 * that the nrecs is valid, the rec array has been set up, and there's
757 * a valid PDAEND record in the raw PDA data.
765 * ~0 - failure (probably an errno)
766 ----------------------------------------------------------------*/
767 int read_cardpda(pda_t
*pda
, wlandevice_t
*wlandev
)
770 p80211msg_p2req_readpda_t msg
;
773 msg
.msgcode
= DIDmsg_p2req_readpda
;
774 msg
.msglen
= sizeof(msg
);
775 strcpy(msg
.devname
, wlandev
->name
);
776 msg
.pda
.did
= DIDmsg_p2req_readpda_pda
;
777 msg
.pda
.len
= HFA384x_PDA_LEN_MAX
;
778 msg
.pda
.status
= P80211ENUM_msgitem_status_no_value
;
779 msg
.resultcode
.did
= DIDmsg_p2req_readpda_resultcode
;
780 msg
.resultcode
.len
= sizeof(u32
);
781 msg
.resultcode
.status
= P80211ENUM_msgitem_status_no_value
;
783 if (prism2mgmt_readpda(wlandev
, &msg
) != 0) {
784 /* prism2mgmt_readpda prints an errno if appropriate */
786 } else if (msg
.resultcode
.data
== P80211ENUM_resultcode_success
) {
787 memcpy(pda
->buf
, msg
.pda
.data
, HFA384x_PDA_LEN_MAX
);
788 result
= mkpdrlist(pda
);
790 /* resultcode must've been something other than success */
797 /*----------------------------------------------------------------
800 * Reads the given fw file which should have been compiled from an srec
801 * file. Each record in the fw file will either be a plain data record,
802 * a start address record, or other records used for plugging.
804 * Note that data records are expected to be sorted into
805 * ascending address order in the fw file.
807 * Note also that the start address record, originally an S7 record in
808 * the srec file, is expected in the fw file to be like a data record but
809 * with a certain address to make it identiable.
811 * Here's the SREC format that the fw should have come from:
812 * S[37]nnaaaaaaaaddd...dddcc
814 * nn - number of bytes starting with the address field
815 * aaaaaaaa - address in readable (or big endian) format
816 * dd....dd - 0-245 data bytes (two chars per byte)
819 * The S7 record's (there should be only one) address value gets
820 * converted to an S3 record with address of 0xff400000, with the
821 * start address being stored as a 4 byte data word. That address is
822 * the start execution address used for RAM downloads.
824 * The S3 records have a collection of subformats indicated by the
826 * 0xff000000 - Plug record, data field format:
827 * xxxxxxxxaaaaaaaassssssss
828 * x - PDR code number (little endian)
829 * a - Address in load image to plug (little endian)
830 * s - Length of plug data area (little endian)
832 * 0xff100000 - CRC16 generation record, data field format:
833 * aaaaaaaassssssssbbbbbbbb
834 * a - Start address for CRC calculation (little endian)
835 * s - Length of data to calculate over (little endian)
836 * b - Boolean, true=write crc, false=don't write
838 * 0xff200000 - Info record, data field format:
840 * s - Size in words (little endian)
841 * t - Info type (little endian), see #defines and
842 * s3inforec_t for details about types.
843 * d - (s - 1) little endian words giving the contents of
844 * the given info type.
846 * 0xff400000 - Start address record, data field format:
848 * a - Address in load image to plug (little endian)
851 * record firmware image (ihex record structure) in kernel memory
855 * ~0 - failure (probably an errno)
856 ----------------------------------------------------------------*/
857 int read_fwfile(const struct ihex_binrec
*record
)
863 u32
*ptr32
, len
, addr
;
865 pr_debug("Reading fw file ...\n");
871 len
= be16_to_cpu(record
->len
);
872 addr
= be32_to_cpu(record
->addr
);
874 /* Point into data for different word lengths */
875 ptr32
= (u32
*) record
->data
;
876 ptr16
= (u16
*) record
->data
;
878 /* parse what was an S3 srec and put it in the right array */
882 pr_debug(" S7 start addr, record=%d "
888 s3plug
[ns3plug
].itemcode
= *ptr32
;
889 s3plug
[ns3plug
].addr
= *(ptr32
+ 1);
890 s3plug
[ns3plug
].len
= *(ptr32
+ 2);
892 pr_debug(" S3 plugrec, record=%d "
893 "itemcode=0x%08x addr=0x%08x len=%d\n",
895 s3plug
[ns3plug
].itemcode
,
896 s3plug
[ns3plug
].addr
,
897 s3plug
[ns3plug
].len
);
900 if (ns3plug
== S3PLUG_MAX
) {
901 printk(KERN_ERR
"S3 plugrec limit reached - aborting\n");
906 s3crc
[ns3crc
].addr
= *ptr32
;
907 s3crc
[ns3crc
].len
= *(ptr32
+ 1);
908 s3crc
[ns3crc
].dowrite
= *(ptr32
+ 2);
910 pr_debug(" S3 crcrec, record=%d "
911 "addr=0x%08x len=%d write=0x%08x\n",
915 s3crc
[ns3crc
].dowrite
);
917 if (ns3crc
== S3CRC_MAX
) {
918 printk(KERN_ERR
"S3 crcrec limit reached - aborting\n");
923 s3info
[ns3info
].len
= *ptr16
;
924 s3info
[ns3info
].type
= *(ptr16
+ 1);
926 pr_debug(" S3 inforec, record=%d "
927 "len=0x%04x type=0x%04x\n",
930 s3info
[ns3info
].type
);
931 if (((s3info
[ns3info
].len
- 1) * sizeof(u16
)) > sizeof(s3info
[ns3info
].info
)) {
932 printk(KERN_ERR
" S3 inforec length too long - aborting\n");
936 tmpinfo
= (u16
*)&(s3info
[ns3info
].info
.version
);
938 for (i
= 0; i
< s3info
[ns3info
].len
- 1; i
++) {
939 tmpinfo
[i
] = *(ptr16
+ 2 + i
);
940 pr_debug("%04x ", tmpinfo
[i
]);
945 if (ns3info
== S3INFO_MAX
) {
946 printk(KERN_ERR
"S3 inforec limit reached - aborting\n");
950 default: /* Data record */
951 s3data
[ns3data
].addr
= addr
;
952 s3data
[ns3data
].len
= len
;
953 s3data
[ns3data
].data
= (uint8_t *) record
->data
;
955 if (ns3data
== S3DATA_MAX
) {
956 printk(KERN_ERR
"S3 datarec limit reached - aborting\n");
961 record
= ihex_next_binrec(record
);
966 /*----------------------------------------------------------------
969 * Takes the chunks, builds p80211 messages and sends them down
970 * to the driver for writing to the card.
974 * fchunk Array of image chunks
975 * nfchunks Number of image chunks
980 ----------------------------------------------------------------*/
981 int writeimage(wlandevice_t
*wlandev
, imgchunk_t
*fchunk
,
982 unsigned int nfchunks
)
985 p80211msg_p2req_ramdl_state_t rstatemsg
;
986 p80211msg_p2req_ramdl_write_t rwritemsg
;
991 unsigned int nwrites
;
996 /* Initialize the messages */
997 memset(&rstatemsg
, 0, sizeof(rstatemsg
));
998 strcpy(rstatemsg
.devname
, wlandev
->name
);
999 rstatemsg
.msgcode
= DIDmsg_p2req_ramdl_state
;
1000 rstatemsg
.msglen
= sizeof(rstatemsg
);
1001 rstatemsg
.enable
.did
= DIDmsg_p2req_ramdl_state_enable
;
1002 rstatemsg
.exeaddr
.did
= DIDmsg_p2req_ramdl_state_exeaddr
;
1003 rstatemsg
.resultcode
.did
= DIDmsg_p2req_ramdl_state_resultcode
;
1004 rstatemsg
.enable
.status
= P80211ENUM_msgitem_status_data_ok
;
1005 rstatemsg
.exeaddr
.status
= P80211ENUM_msgitem_status_data_ok
;
1006 rstatemsg
.resultcode
.status
= P80211ENUM_msgitem_status_no_value
;
1007 rstatemsg
.enable
.len
= sizeof(u32
);
1008 rstatemsg
.exeaddr
.len
= sizeof(u32
);
1009 rstatemsg
.resultcode
.len
= sizeof(u32
);
1011 memset(&rwritemsg
, 0, sizeof(rwritemsg
));
1012 strcpy(rwritemsg
.devname
, wlandev
->name
);
1013 rwritemsg
.msgcode
= DIDmsg_p2req_ramdl_write
;
1014 rwritemsg
.msglen
= sizeof(rwritemsg
);
1015 rwritemsg
.addr
.did
= DIDmsg_p2req_ramdl_write_addr
;
1016 rwritemsg
.len
.did
= DIDmsg_p2req_ramdl_write_len
;
1017 rwritemsg
.data
.did
= DIDmsg_p2req_ramdl_write_data
;
1018 rwritemsg
.resultcode
.did
= DIDmsg_p2req_ramdl_write_resultcode
;
1019 rwritemsg
.addr
.status
= P80211ENUM_msgitem_status_data_ok
;
1020 rwritemsg
.len
.status
= P80211ENUM_msgitem_status_data_ok
;
1021 rwritemsg
.data
.status
= P80211ENUM_msgitem_status_data_ok
;
1022 rwritemsg
.resultcode
.status
= P80211ENUM_msgitem_status_no_value
;
1023 rwritemsg
.addr
.len
= sizeof(u32
);
1024 rwritemsg
.len
.len
= sizeof(u32
);
1025 rwritemsg
.data
.len
= WRITESIZE_MAX
;
1026 rwritemsg
.resultcode
.len
= sizeof(u32
);
1028 /* Send xxx_state(enable) */
1029 pr_debug("Sending dl_state(enable) message.\n");
1030 rstatemsg
.enable
.data
= P80211ENUM_truth_true
;
1031 rstatemsg
.exeaddr
.data
= startaddr
;
1033 msgp
= (p80211msg_t
*) &rstatemsg
;
1034 result
= prism2mgmt_ramdl_state(wlandev
, msgp
);
1037 "writeimage state enable failed w/ result=%d, "
1038 "aborting download\n", result
);
1041 resultcode
= rstatemsg
.resultcode
.data
;
1042 if (resultcode
!= P80211ENUM_resultcode_success
) {
1044 "writeimage()->xxxdl_state msg indicates failure, "
1045 "w/ resultcode=%d, aborting download.\n", resultcode
);
1049 /* Now, loop through the data chunks and send WRITESIZE_MAX data */
1050 for (i
= 0; i
< nfchunks
; i
++) {
1051 nwrites
= fchunk
[i
].len
/ WRITESIZE_MAX
;
1052 nwrites
+= (fchunk
[i
].len
% WRITESIZE_MAX
) ? 1 : 0;
1054 for (j
= 0; j
< nwrites
; j
++) {
1056 (fchunk
[i
].len
- (WRITESIZE_MAX
* j
)) >
1057 WRITESIZE_MAX
? WRITESIZE_MAX
: (fchunk
[i
].len
-
1060 curroff
= j
* WRITESIZE_MAX
;
1061 currdaddr
= fchunk
[i
].addr
+ curroff
;
1062 /* Setup the message */
1063 rwritemsg
.addr
.data
= currdaddr
;
1064 rwritemsg
.len
.data
= currlen
;
1065 memcpy(rwritemsg
.data
.data
,
1066 fchunk
[i
].data
+ curroff
, currlen
);
1068 /* Send flashdl_write(pda) */
1070 ("Sending xxxdl_write message addr=%06x len=%d.\n",
1071 currdaddr
, currlen
);
1073 msgp
= (p80211msg_t
*) &rwritemsg
;
1074 result
= prism2mgmt_ramdl_write(wlandev
, msgp
);
1076 /* Check the results */
1079 "writeimage chunk write failed w/ result=%d, "
1080 "aborting download\n", result
);
1083 resultcode
= rstatemsg
.resultcode
.data
;
1084 if (resultcode
!= P80211ENUM_resultcode_success
) {
1086 "writeimage()->xxxdl_write msg indicates failure, "
1087 "w/ resultcode=%d, aborting download.\n",
1095 /* Send xxx_state(disable) */
1096 pr_debug("Sending dl_state(disable) message.\n");
1097 rstatemsg
.enable
.data
= P80211ENUM_truth_false
;
1098 rstatemsg
.exeaddr
.data
= 0;
1100 msgp
= (p80211msg_t
*) &rstatemsg
;
1101 result
= prism2mgmt_ramdl_state(wlandev
, msgp
);
1104 "writeimage state disable failed w/ result=%d, "
1105 "aborting download\n", result
);
1108 resultcode
= rstatemsg
.resultcode
.data
;
1109 if (resultcode
!= P80211ENUM_resultcode_success
) {
1111 "writeimage()->xxxdl_state msg indicates failure, "
1112 "w/ resultcode=%d, aborting download.\n", resultcode
);
1118 int validate_identity(void)
1124 pr_debug("NIC ID: %#x v%d.%d.%d\n",
1125 nicid
.id
, nicid
.major
, nicid
.minor
, nicid
.variant
);
1126 pr_debug("MFI ID: %#x v%d %d->%d\n",
1127 rfid
.id
, rfid
.variant
, rfid
.bottom
, rfid
.top
);
1128 pr_debug("CFI ID: %#x v%d %d->%d\n",
1129 macid
.id
, macid
.variant
, macid
.bottom
, macid
.top
);
1130 pr_debug("PRI ID: %#x v%d %d->%d\n",
1131 priid
.id
, priid
.variant
, priid
.bottom
, priid
.top
);
1133 for (i
= 0; i
< ns3info
; i
++) {
1134 switch (s3info
[i
].type
) {
1136 pr_debug("Version: ID %#x %d.%d.%d\n",
1137 s3info
[i
].info
.version
.id
,
1138 s3info
[i
].info
.version
.major
,
1139 s3info
[i
].info
.version
.minor
,
1140 s3info
[i
].info
.version
.variant
);
1143 pr_debug("Compat: Role %#x Id %#x v%d %d->%d\n",
1144 s3info
[i
].info
.compat
.role
,
1145 s3info
[i
].info
.compat
.id
,
1146 s3info
[i
].info
.compat
.variant
,
1147 s3info
[i
].info
.compat
.bottom
,
1148 s3info
[i
].info
.compat
.top
);
1150 /* MAC compat range */
1151 if ((s3info
[i
].info
.compat
.role
== 1) &&
1152 (s3info
[i
].info
.compat
.id
== 2)) {
1153 if (s3info
[i
].info
.compat
.variant
!=
1159 /* PRI compat range */
1160 if ((s3info
[i
].info
.compat
.role
== 1) &&
1161 (s3info
[i
].info
.compat
.id
== 3)) {
1162 if ((s3info
[i
].info
.compat
.bottom
> priid
.top
)
1163 || (s3info
[i
].info
.compat
.top
<
1168 /* SEC compat range */
1169 if ((s3info
[i
].info
.compat
.role
== 1) &&
1170 (s3info
[i
].info
.compat
.id
== 4)) {
1171 /* FIXME: isn't something missing here? */
1176 pr_debug("Seq: %#x\n", s3info
[i
].info
.buildseq
);
1180 pr_debug("Platform: ID %#x %d.%d.%d\n",
1181 s3info
[i
].info
.version
.id
,
1182 s3info
[i
].info
.version
.major
,
1183 s3info
[i
].info
.version
.minor
,
1184 s3info
[i
].info
.version
.variant
);
1186 if (nicid
.id
!= s3info
[i
].info
.version
.id
)
1188 if (nicid
.major
!= s3info
[i
].info
.version
.major
)
1190 if (nicid
.minor
!= s3info
[i
].info
.version
.minor
)
1192 if ((nicid
.variant
!= s3info
[i
].info
.version
.variant
) &&
1193 (nicid
.id
!= 0x8008))
1199 pr_debug("name inforec len %d\n", s3info
[i
].len
);
1203 pr_debug("Unknown inforec type %d\n", s3info
[i
].type
);
1208 if (trump
&& (result
!= 2))