selftests/bpf: fix test_xdp_noinline on s390
[sfrench/cifs-2.6.git] / Documentation / usb / rio.txt
1 ============
2 Diamonds Rio
3 ============
4
5 Copyright (C) 1999, 2000 Bruce Tenison
6
7 Portions Copyright (C) 1999, 2000 David Nelson
8
9 Thanks to David Nelson for guidance and the usage of the scanner.txt
10 and scanner.c files to model our driver and this informative file.
11
12 Mar. 2, 2000
13
14 Changes
15 =======
16
17 - Initial Revision
18
19
20 Overview
21 ========
22
23 This README will address issues regarding how to configure the kernel
24 to access a RIO 500 mp3 player.
25 Before I explain how to use this to access the Rio500 please be warned:
26
27 .. warning::
28
29    Please note that this software is still under development.  The authors
30    are in no way responsible for any damage that may occur, no matter how
31    inconsequential.
32
33 It seems that the Rio has a problem when sending .mp3 with low batteries.
34 I suggest when the batteries are low and you want to transfer stuff that you
35 replace it with a fresh one. In my case, what happened is I lost two 16kb
36 blocks (they are no longer usable to store information to it). But I don't
37 know if that's normal or not; it could simply be a problem with the flash
38 memory.
39
40 In an extreme case, I left my Rio playing overnight and the batteries wore
41 down to nothing and appear to have corrupted the flash memory. My RIO
42 needed to be replaced as a result.  Diamond tech support is aware of the
43 problem.  Do NOT allow your batteries to wear down to nothing before
44 changing them.  It appears RIO 500 firmware does not handle low battery
45 power well at all.
46
47 On systems with OHCI controllers, the kernel OHCI code appears to have
48 power on problems with some chipsets.  If you are having problems
49 connecting to your RIO 500, try turning it on first and then plugging it
50 into the USB cable.
51
52 Contact Information
53 -------------------
54
55    The main page for the project is hosted at sourceforge.net in the following
56    URL: <http://rio500.sourceforge.net>. You can also go to the project's
57    sourceforge home page at: <http://sourceforge.net/projects/rio500/>.
58    There is also a mailing list: rio500-users@lists.sourceforge.net
59
60 Authors
61 -------
62
63 Most of the code was written by Cesar Miquel <miquel@df.uba.ar>. Keith
64 Clayton <kclayton@jps.net> is incharge of the PPC port and making sure
65 things work there. Bruce Tenison <btenison@dibbs.net> is adding support
66 for .fon files and also does testing. The program will mostly sure be
67 re-written and Pete Ikusz along with the rest will re-design it. I would
68 also like to thank Tri Nguyen <tmn_3022000@hotmail.com> who provided use
69 with some important information regarding the communication with the Rio.
70
71 Additional Information and userspace tools
72
73         http://rio500.sourceforge.net/
74
75
76 Requirements
77 ============
78
79 A host with a USB port running a Linux kernel with RIO 500 support enabled.
80
81 The driver is a module called rio500, which should be automatically loaded
82 as you plug in your device. If that fails you can manually load it with
83
84   modprobe rio500
85
86 Udev should automatically create a device node as soon as plug in your device.
87 If that fails, you can manually add a device for the USB rio500::
88
89   mknod /dev/usb/rio500 c 180 64
90
91 In that case, set appropriate permissions for /dev/usb/rio500 (don't forget
92 about group and world permissions).  Both read and write permissions are
93 required for proper operation.
94
95 That's it.  The Rio500 Utils at: http://rio500.sourceforge.net should
96 be able to access the rio500.
97
98 Limits
99 ======
100
101 You can use only a single rio500 device at a time with your computer.
102
103 Bugs
104 ====
105
106 If you encounter any problems feel free to drop me an email.
107
108 Bruce Tenison
109 btenison@dibbs.net