Compare commits

1 Commits

Author SHA1 Message Date
5b731a2d99 README.md revision 2020-09-21 15:24:48 +03:00

View File

@@ -1,5 +1,5 @@
R5U87x Userspace Tools
Version 0.2.1, 2009/11/22
Version 0.2.2, 2020/09/21
Introduction
============
@@ -29,77 +29,32 @@ installed:
Quickstart
==========
Ubuntu
$ sudo apt-get install libglib2.0-dev libusb-dev build-essential gcc automake mercurial
$ hg clone http://bitbucket.org/ahixon/r5u87x/
$ cd r5u87x
$ make
$ sudo make install
$ sudo r5u87x-loader --reload
The loader will automatically be run on boot when it detects your webcam.
Installation from source
========================
Simply install the dependencies required above on your system, then run
'make'.
Now you can proceed to installing the tool system-wide:
# make install
If you have udev installed, your system will automatically load the firmware
to the camera, and then reload the uvcvideo module at boot time.
Please note that the loader is installed system-wide as 'r5u87x-loader', but
compiles as just 'loader'.
You can either reboot or follow the instructions below.
Usage
=====
To upload the firmware to your camera, simply run (as root):
# loader --reload
`# ricoh-webcam-loader`
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,
however, won't.
If your camera appears to be playing up, you can try forcefully resetting it:
# loader --force-clear
`# r5u87x-loader --force-clear`
There are also useful arguments for testing, see docs/extracting_ucode.txt
Bugs
====
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/
Please note WDM devices WILL NOT WORK.
You can check what type of model you have by looking at the model chart found
in docs/model_matrix.txt. If you're running a WDM based device, you can try to
look on the internet for a patched version of r5u870, however it will probably
not work with more recent kernels.
You should also register, otherwise you may not get notifications of any
replies to your bug.
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.
Copyrights and Licenses
=======================
Copyright (c) 2008-2009 Alexander Hixon <alex@alexhixon.com>
Copyright (c) 2020- linuxer <linuxer@artixlinux.com>
These tools are licensed to you under the terms of the GNU GPL v2 or, at your
option, any later version. See the included file 'COPYING' for license.