• Home
  • History
  • Annotate
  • current directory
Name Date Size #Lines LOC

..16-Aug-2019-

m4/H16-Aug-2019-

COPYINGH A D26-Dec-200217.6 KiB341281

ChangeLogH A D11-Dec-200515.9 KiB482319

Makefile.amH A D10-Dec-2005450 1710

Makefile.inH A D10-Dec-200526.7 KiB701618

NEWSH A D03-Dec-20052.8 KiB9074

READMEH A D11-Dec-20054.6 KiB125109

TIPSH A D04-Sep-20042.7 KiB7551

aclocal.m4H A D03-Dec-200530.5 KiB856769

compileH A D03-Dec-20053.6 KiB14379

config.guessH A D03-Dec-200542.7 KiB1,4641,261

config.h.inH A D03-Dec-20053.2 KiB12282

config.rpathH A D28-Nov-200514.5 KiB572480

config.subH A D03-Dec-200530.5 KiB1,5561,412

configureH A D16-Aug-2019203.4 KiB6,8775,708

configure.acH A D03-Dec-2005846 3729

depcompH A D03-Dec-200515.6 KiB531330

ifp.1H A D03-Dec-20053.7 KiB10993

ifp.cH A D11-Dec-20058 KiB295214

ifp_routines.cH A D03-Dec-200541.3 KiB1,6711,278

ifp_routines.hH A D10-Dec-20051.7 KiB4429

install-shH A D03-Dec-20059 KiB324189

missingH A D03-Dec-200510.8 KiB361268

nonroot.shH A D11-Dec-20053.8 KiB135101

unicodehack.cH A D03-Dec-20052 KiB9362

unicodehack.hH A D10-Dec-2005286 105

README

1WARNING!!! This an BETA software for testing purpose!!!
2
3ABOUT
4    - this project aims to be an open-source driver for iRiver iFP flash player
5    - currently, it's a command line utility, which uses libusb to access USB
6    - one can use Midnight Commander as frontend
7    - ifp supported manager firmware; not supported UMS firmware
8    - http://ifp-driver.sourceforge.net/
9
10AUTHOR
11    Pavel Kriz <pavkriz@gybon.cz>
12    Yamashiro, Jun <yamajun@{ofug.net, cr.ie.u-ryukyu.ac.jp}>
13    Roback, Joe <joe@roback.cc>, 7XX and 8XX support
14
15TESTED ON
16    - RedHat Linux 7.3 (x86), Gentoo Linux 2004.0
17      FreeBSD/i386 4.x/5.x, NetBSD-current(2.x-3.99.x)/{amd64,i386},
18      Mac OS X(Jaguar/Tiger),
19    - libusb-0.1.7, libusb-0.1.8, libusb-0.1.10a
20    - iRiver iFP-1XX series firmware 1.17-3.55,
21      iriver iFP-7XX series firmware 1.10-1.65
22
23INSTALLATION
24    % ./configure
25    % make
26    % su
27    # make install	(copy to $(PREFIX)/bin	default: /usr/local/bin )
28
29    And this command is required when you install ifp-line for the first time:
30    # ./nonroot.sh	(configuration for run ifp command by non-root users)
31
32USAGE
33    ./ifp [option] command params
34    (Need permission to read/write USB device for run ifp)
35
36    - options:
37	-h, --help
38	    Print help message.
39
40    - commands:
41        ls [directory]
42        df
43        upload localfile ifptarget
44        upload localdir  ifpdir
45        download ifpfile localtarget
46        download ifpdir  localdir
47        rm [-r] file
48        rmdir dir
49        mkdir dir
50	battery
51	typestring
52	firmversion
53	format
54	firmupdate /path/to/FIRMWARE.HEX
55	help
56	version
57
58COMMENTS
59    - terms UPLOAD & DOWNLOAD are inversed against those stupid iRiverManager's
60	- so I use UPLOAD from Computer to iFP, DOWNLOAD from iFP to Computer
61    - iFP has a unix-like behaviour
62	- filenames are case sensitive
63	- it's possible to have `folder' & `FOLDER' directories besides
64    - no wildcards support - only a single file can be down/uploaded
65    - on download *.REC file, convert it *.REC file to wav(iFP-1XX) or
66      rename it *.REC to mp3(iFP-3XX, iFP-5XX)
67	- need install ifprecconv (http://ifp-driver.sourceforge.net) for
68	  convert *.REC to *.wav
69    - if you want to run ifp by non-root user, please run nonroot.sh by root
70	(But, this script isn't perfect.  if failed this script,
71	try to configuration yourself with "TIPS" document)
72
73SETTING-UP MIDNIGHT COMMANDER SUPPORT
74    - you can use mc (http://www.gnome.org/mc/) as frontend to this commandline
75      utility
76    * Step 1
77	- compile ifp by typing `make' here
78    * Step 2
79	- check it works (try `./ifp ls /' to obtain root folder listing)
80	- maybe, you have to run it under root's privileges
81    * Step 3
82	- find your mc's `extfs.ini' file (/usr/lib/mc/extfs/extfs.ini on my
83	  distribution)
84	- add line `ifp' (without quotes) to this file (probably need root)
85    * Step 4
86	- copy ./ifp (executable) to the same directory, where did you found
87	  extfs.ini file (probably need root)
88    = Now, you can run `mc' (under the user, who can write to usb - refer
89      to step 2) and type `cd #ifp' to see iFP's filesystem
90    - access to the filesystem is cached, so if you doubt, exit mc and run
91      again (any suggestions, how to solve this?)
92
93DANGEROUS
94    - battery status is not tested while uploading
95	- original iRiverManager recommends not to up/download when a
96	  battery is going to be empty
97    - some parameters are hardcoded although, iFP may provide them
98	- possible bugs against another firmware version
99
100BAD IMPLEMENTATION
101    - before uploading, file size should be sent to iFP (because of free
102      space checking, I expect - or some allocations???), but I send 0 and
103      it works...
104
105TROUBLESHOOTING
106    - be sure that you have usbdevfs support either built into your kernel, or
107      loaded as a module; additionally, be sure that usbdevfs is mounted in
108      proc. (thx morbie@legions.org)
109    - "Could not find any USB busses." - no usbdevfs available; be sure,
110      you have usb-enabled kernel
111    - "iRiver iFP not found." - usb is available, but iFP doesn't seem to be
112      connected; make sure "usb connected" is displayed on the unit;
113      cable reconnecting may sometimes help; try some utility to check your
114      usb topology (http://www.kroah.com/linux-usb/)
115    - "Unable to open iFP device." - device is used by another process or you
116      have no rights to write to usb devices, try to do that under root's
117      privileges
118    - if you get wrong output of non-ASCII filename, set correct locale
119      value(ex: set "ja_JP.eucJP" for Japanese EUC) to environment variable
120      such as "LANG" or "LC_ALL".
121
122MAILING LIST
123    - http://lists.sourceforge.net/lists/listinfo/ifp-driver-common/
124
125