Michael,

Below is yet another revision to the README for ssb-sprom. This
version uses the --subv switch to replace the vendor ID and gets rid
of the back ticks in both places.

Larry


Index: ssb_sprom/README
===================================================================
--- ssb_sprom.orig/README
+++ ssb_sprom/README
@@ -13,3 +13,81 @@ Requirements
  ------------

  1)    C99 compatible compiler.
+
+Usage
+-----
+
+The contents of the sprom are exposed to the user in sysfs. This
+tool can, in principle, read and write the sprom in place; however,
+making a mistake during sprom writing could render your device
+unusable. For this reason, we recommend copying the sprom contents
+to disk as the first step. This copy can then be modified until it
+contains the desired new information. Only then and with caution
+should the sprom be rewritten. DO NOT MAKE ANY CHANGES UNLESS YOU
+KNOW WHAT YOU ARE DOING!!!! You have been warned!!!
+
+Obtaining a disk copy of the sprom contents
+-------------------------------------------
+
+This file name for the sprom contents depends on the bus layout of
+the specific computer being used and will be something cryptic like
+
+/sys/devices/pci0000:00/0000:00:02.0/0000:01:00.0/ssb_sprom
+
+It is not recommended that you try to type the name. Instead, you
+should use the following commands to get the working copy:
+
+SSB_SPROM=$(find /sys -name ssb_sprom)
+sudo cat $SSB_SPROM > ssb_sprom_copy
+
+Modifying the contents of the working copy
+------------------------------------------
+
+You may now look at the contents of your sprom with the command
+
+ssb-sprom -i ssb_sprom_copy -P
+
+As an example, let us suppose that you have purchased a Dell mini-pci
+card to use in an HP laptop. The HP BIOS refuses to use the card when
+the pcivendor is Dell (code 0x1028), not HP (code 0x103C). From the
+information provided by the "ssb-prom --help" command, we learn that
+the switch needed to change this vendor code is "--subv". To change
+that code, we use the command
+
+ssb-sprom -i ssb_sprom_copy -o new_ssb_sprom_copy --subv 0x103C
+
+to write the HP vendor ID to our working copy. I use different
+input and output files so as not to destroy the original. If further
+changes are needed, for example the PCI product ID, the command
+
+ssb-sprom -i new_ssb_sprom_copy -o new_ssb_sprom_copy --subp 0x137C
+
+would be used. Note that the input and output files may be the same.
+Once you think you have updated correctly, use
+
+ssb-sprom -i new_ssb_sprom_copy -P
+
+to check the contents.
+
+Rewriting the sprom contents
+----------------------------
+
+Once the sprom contents are the way you want them, and presumably
+correct, you are ready to rewrite the file. If you have logged out
+since the working copy of the sprom contents was obtained, the symbol
+containing the location of the file in sysfs will have been lost. In
+any case, it is safe to reload that symbol again with
+
+SSB_SPROM=$(find /sys -name ssb_sprom)
+
+You are then ready to rewrite the sprom with
+
+sudo cp new_ssb_sprom_copy $SSB_SPROM
+
+Once again, you are urged to be absolutely certain of the contents
+of the working copy BEFORE taking this step. If your interface
+becomes unusable as a result of writing incorrect data into the
+sprom, the responsibility is YOURS. Once again, you have been warned.
+
+----------
+

_______________________________________________
Bcm43xx-dev mailing list
[email protected]
https://lists.berlios.de/mailman/listinfo/bcm43xx-dev

Reply via email to