Re: RFC: a new version of bcm43xx.txt

2007-02-07 Thread Cristian Aravena Romero
On 2/7/07, Larry Finger [EMAIL PROTECTED] wrote:

[...]

 +http://developer.berlios.de/project/showfiles.php?group_id=4547.

-http://developer.berlios.de/project/showfiles.php?group_id=4547.
+http://developer.berlios.de/project/showfiles.php?group_id=4547


[...]

 +http://downloads.openwrt.org/sources/wl_apsta-3.130.20.0.o.

-http://downloads.openwrt.org/sources/wl_apsta-3.130.20.0.o.
+http://downloads.openwrt.org/sources/wl_apsta-3.130.20.0.o
--
Cristian Aravena Romero
___
Bcm43xx-dev mailing list
Bcm43xx-dev@lists.berlios.de
https://lists.berlios.de/mailman/listinfo/bcm43xx-dev


Re: RFC: a new version of bcm43xx.txt

2007-02-07 Thread Pavel Roskin
On Wed, 2007-02-07 at 19:49 -0600, Larry Finger wrote:

 +This driver has been developend using a clean-room technique that is 
 described

developed

 +Since the release of the 2.6.17 kernel, the bcm43xx driver has been 
 dstributed

distributed

Please make sure to spell check the final edition.

 +with the kernel source, and is prebuilt in most, if not all, distributions.
 +There is, however, additional software that is required. Because the firmware
 +used by the processor in the Broadcom chip is copyrighted, it is not possible
 +for any third party to distribute it.

Strictly speaking, Linux is copyrighted too.  It would be better to
rephrase it to mention the specific restrictions, whatever they are.

  Furthermore, it cannot be placed in the
 +downloadable archives of any distributing organization; therefore, the user 
 is
 +responsible for obtaining the firmware and placing it in the appropriate 
 location
 +so that the driver can find it when initializing.

But how come it's on openwrt.org then?

 +To help with this process, the bcm43xx developers provide a separate program
 +named bcm43xx-fwcutter to cut the firmware out of a Windows or OS X driver
 +and write the extracted files to the proper location. This program is usually
 +provided with the distribution; however, it may be downloaded from
 +
 +http://developer.berlios.de/project/showfiles.php?group_id=4547.
 +
 +The firmware is available in two versions. V3 firmware is used with the 
 in-kernel
 +bcm43xx driver that uses a software MAC layer called SoftMAC, and will have a
 +microcode revision of 0x127 or smaller. The V4 firmware is used by an 
 out-of-kernel
 +driver employing a variation of the devicescape MAC layer known as d80211. 
 Once
 +bcm43xx-d80211 reaches a satisfactory level of development, it will replace
 +bcm43xx-softmac in the kernel as it is much more flexible and powerful.
 +
 +A source for rev 0x127 (V3) firmware is

I'm not sure why you are repeating this 0x127 over and over again.  It
seems a minor detail that even fwcutter docs don't mention.  The
important part is v3 vs v4.

 +http://downloads.openwrt.org/sources/wl_apsta-3.130.20.0.o.
 +
 +Once this file is downloaded, the command 'bcm43xx-fwcutter -i filename' 
 will list
 +the blobs of microcode in the file. The command 'bcm43xx-fwcutter -w dir 
 filename'
 +will extract the microcode and write it to directory dir.

Sorry for a naive question.  How hard would is be to run fwcutter once,
zip the firmware and put it to the same directory on the same site?

  The correct directory
 +will depend on your distribution; however, most use '/lib/firmware'. Once 
 this
 +step is completed, the bcm3xx driver should load when the system is booted. 
 To see
 +any messages relating to the driver, issue the command 'dmesg | grep 
 bcm43xx' from
 +a terminal window. If there are any problems, please send that output to
 [EMAIL PROTECTED]
 +
 +Although the driver has been in-kernel since 2.6.17, the earlier versions 
 are quite
 +limited in their capability. Patches for each of the stable kernel versions 
 from
 +2.6.18 onward are available to include all features of later versions. These 
 will
 +be needed if you use a BCM4318, or a PCI-E version (BCM4311 and BCM4312). In 
 addition,

I think PCIe is a preferred abbreviation.  Or maybe just write PCI
Express.

 +if you have an early BCM4306 and more than 1 GB RAM, your kernel will need 
 to be
 +patched. These patches, which are being updated regularly, are available at
 +ftp://lwfinger.dynalias.org/patches. Look for kernel 
 version_combined_patch. Of
 +course you will need kernel source, either downloaded from kernel.org, or 
 the source
 +from your distribution.

Could you please rename those patches to add .diff ot .path to the
names?  Many editors would highlight the patches nicely if they are
maned like this.  Not to mention that files ending with a dot-number
could be mistaken for a manual page.

-- 
Regards,
Pavel Roskin

___
Bcm43xx-dev mailing list
Bcm43xx-dev@lists.berlios.de
https://lists.berlios.de/mailman/listinfo/bcm43xx-dev


Re: RFC: a new version of bcm43xx.txt

2007-02-07 Thread Larry Finger
Pavel Roskin wrote:
 On Wed, 2007-02-07 at 19:49 -0600, Larry Finger wrote:
 
 +This driver has been developend using a clean-room technique that is 
 described
 
 developed
 
 +Since the release of the 2.6.17 kernel, the bcm43xx driver has been 
 dstributed
 
 distributed
 
 Please make sure to spell check the final edition.
 
 +with the kernel source, and is prebuilt in most, if not all, distributions.
 +There is, however, additional software that is required. Because the 
 firmware
 +used by the processor in the Broadcom chip is copyrighted, it is not 
 possible
 +for any third party to distribute it.
 
 Strictly speaking, Linux is copyrighted too.  It would be better to
 rephrase it to mention the specific restrictions, whatever they are.

A good suggestion - perhaps some other reader might suggest language here.

  Furthermore, it cannot be placed in the
 +downloadable archives of any distributing organization; therefore, the user 
 is
 +responsible for obtaining the firmware and placing it in the appropriate 
 location
 +so that the driver can find it when initializing.
 
 But how come it's on openwrt.org then?

Linksys used Linux on the older versions of the WRT54G. According to the GPL, 
they have to make the
system available. Of course, it is within their rights to provide the driver in 
a binary-only form
and openwrt.org is allowed to redistibute the entire system. BTW, Linksys now 
uses VxWorks, which
doesn't have the GPL problem.
 
 +To help with this process, the bcm43xx developers provide a separate program
 +named bcm43xx-fwcutter to cut the firmware out of a Windows or OS X driver
 +and write the extracted files to the proper location. This program is 
 usually
 +provided with the distribution; however, it may be downloaded from
 +
 +http://developer.berlios.de/project/showfiles.php?group_id=4547.
 +
 +The firmware is available in two versions. V3 firmware is used with the 
 in-kernel
 +bcm43xx driver that uses a software MAC layer called SoftMAC, and will have 
 a
 +microcode revision of 0x127 or smaller. The V4 firmware is used by an 
 out-of-kernel
 +driver employing a variation of the devicescape MAC layer known as d80211. 
 Once
 +bcm43xx-d80211 reaches a satisfactory level of development, it will replace
 +bcm43xx-softmac in the kernel as it is much more flexible and powerful.
 +
 +A source for rev 0x127 (V3) firmware is
 
 I'm not sure why you are repeating this 0x127 over and over again.  It
 seems a minor detail that even fwcutter docs don't mention.  The
 important part is v3 vs v4.
 
 +http://downloads.openwrt.org/sources/wl_apsta-3.130.20.0.o.
 +
 +Once this file is downloaded, the command 'bcm43xx-fwcutter -i filename' 
 will list
 +the blobs of microcode in the file. The command 'bcm43xx-fwcutter -w 
 dir filename'
 +will extract the microcode and write it to directory dir.
 
 Sorry for a naive question.  How hard would is be to run fwcutter once,
 zip the firmware and put it to the same directory on the same site?

AFAIK, we are not allowed to do anything like that.

  The correct directory
 +will depend on your distribution; however, most use '/lib/firmware'. Once 
 this
 +step is completed, the bcm3xx driver should load when the system is booted. 
 To see
 +any messages relating to the driver, issue the command 'dmesg | grep 
 bcm43xx' from
 +a terminal window. If there are any problems, please send that output to
 [EMAIL PROTECTED]
 +
 +Although the driver has been in-kernel since 2.6.17, the earlier versions 
 are quite
 +limited in their capability. Patches for each of the stable kernel versions 
 from
 +2.6.18 onward are available to include all features of later versions. 
 These will
 +be needed if you use a BCM4318, or a PCI-E version (BCM4311 and BCM4312). 
 In addition,
 
 I think PCIe is a preferred abbreviation.  Or maybe just write PCI
 Express.
 
 +if you have an early BCM4306 and more than 1 GB RAM, your kernel will need 
 to be
 +patched. These patches, which are being updated regularly, are available at
 +ftp://lwfinger.dynalias.org/patches. Look for kernel 
 version_combined_patch. Of
 +course you will need kernel source, either downloaded from kernel.org, or 
 the source
 +from your distribution.
 
 Could you please rename those patches to add .diff ot .path to the
 names?  Many editors would highlight the patches nicely if they are
 maned like this.  Not to mention that files ending with a dot-number
 could be mistaken for a manual page.

I changed the name to combined_patch_2_6_20, etc. Once d80211 becomes the 
in-kernel version, I
will keep a patch set for those people with 802.11b cards that do not work with 
V4 firmware.

Larry
___
Bcm43xx-dev mailing list
Bcm43xx-dev@lists.berlios.de
https://lists.berlios.de/mailman/listinfo/bcm43xx-dev