1.0, 200 8/0 9/30
+Version 0..0, 200/0
* libusb development packages (libusb-dev or similar)
* GLib 2.0 development packages (libglib2.0-dev or similar)
Compilation itself is reasonably simple; just run make:
+If you'd like your system to automatically load the firmware to the camera,
+and then reload the uvcvideo module at boot time, simply run:
+Now you can proceed to installing the tool system-wide:
To upload the firmware to your camera, simply run (possibly as root, depending
Do note that this only lasts while the camera still has power to it. Shutting
down and starting up again will cause the camera to lose its state. Rebooting,
You may need to reload your kernel module (eg. uvcvideo) for it to notice your
-camera now that it has firmware.
+camera now that it has firmware. You can either get the loader tool to do this
+ # r5u87x-loader --reload
+at boot time, by following the instructions above (see Installation), or by
+ # modprobe -r uvcvideo; modprobe uvcvideo
If your camera appears to be playing up, you can try forcefully resetting it:
$ ./loader --force-clear
+ loader --force-clear
There are also useful arguments for testing, see doc/extracting_ucode.txt
-Please, report any bugs by creating a new ticket at
+The following issues are known already, so please *do not* report them (you
+can, however, subscribe to any of these tickets):
+ * Broken pipe (code 32) - http://www.bitbucket.org/ahixon/r5u87x/issue/6/
+ * Distorted/stripy video - http://www.bitbucket.org/ahixon/r5u87x/issue/17/
+ * HP Pavillion dv9000 or similar aren't detected (make sure you uncomment
+ only *ONE* device, not both) - http://bitbucket.org/ahixon/r5u87x/issue/26/
+ * Upside down video - http://www.bitbucket.org/ahixon/r5u87x/issue/7/
+If /dev/video does not exist or applications don't detect a webcam, even though
+the loader reported that the firmware was uploaded fine, please report a bug
+with [WDM OK] in the title.
+You should also register, otherwise you may not get notifications of any
+Report any bugs by creating a new ticket at
http://www.bitbucket.org/ahixon/r5u87x/issues/new/. If possible, make sure
that the bug you have hasn't already been reported by searching the issue list.
-Copyright (c) 2008 Alexander Hixon <email@example.com>
+Copyright (c) 2008- Alexander Hixon <firstname.lastname@example.org>
These tools are licensed to you under the terms of the GNU GPL v2. See
the included file 'COPYING'.
Huge kudos to Sam Revitch for writing the original r5u870 driver.
Additional thanks to those who helped Sam develop the driver.
+Many thanks to Willem van Engen for working on getting this included into
+Ubuntu, as well as helping me with my Makefile writing, writing the udev
+template and awk/sed scripts, and creating a Debian package.
+Thanks to Gonzalo Alvarez for testing the 1812 driver and providing usbsnoop
Thanks to Utz-Uwe Haus for getting the Sony VGP-VCC7 firmware extracted, and
providing a patch against the original r5u870 driver, and providing the
firmwares and their associated version numbers.
Thanks to 'franz' for providing an updated version of 183b driver, and testing.
-Thanks to Gonzalo Alvarez for testing the 1812 driver and providing usbsnoop