README 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. This is a set of tools for debugging the b43 driver and/or firmware.
  2. Note that it is licensed under the GNU GPL version 3 ONLY!
  3. Installing:
  4. Run the install.py script as root.
  5. *******************************************************************************
  6. * b43-fwdump *
  7. *******************************************************************************
  8. b43-fwdump is an utility for dumping the current status of the device firmware
  9. on a running device. It has some auto-detection mechanisms. So if you have
  10. only one card in the machine, it will dump the firmware state of that card, if
  11. called without any parameters.
  12. Use the --shm option, if you want a Shared Memory dump.
  13. Use the --binary option, if you want b43-fwdump to automatically dump the
  14. disassembled code at the current PC. This is convenient for debugging
  15. firmware crashes.
  16. Note that b43-fwdump _must_ be run as root, as it needs direct access to the
  17. hardware through debugfs.
  18. Debugfs must be mounted and you must have a recent driver with support for raw
  19. hardware access through debugfs.
  20. If you get error messages about missing debugfs files, make sure to upgrade to
  21. the latest development snapshot of the b43 driver.
  22. *******************************************************************************
  23. * b43-beautifier *
  24. *******************************************************************************
  25. b43-beautifier is a tool to replace constant expressions in raw disassembled
  26. firmware code with human-readable #defined names.
  27. The tool requires either the disassembled source code or a binary (which it
  28. will disassemble then) to start with. See the --asmfile and --binfile
  29. parameters.
  30. It also requires a path to the directory containing the hardware definitions.
  31. This is the "common" subdirectory found in the b43-ucode GIT repository.
  32. See the --defs parameter.
  33. Please be careful when using these tools. Some of them have direct access to
  34. the hardware, so you can easily crash something.
  35. Michael