nope.1

linux下驱动程序设计的文章

.\" 
.\" nope.man:
.\"
.\" Copyright (c) 2001 James McKenzie <[e-mail]>,
.\" All rights reserved.
.\"
.\" $Id:$
.\"
.\" $Log:$
.\"
.TH NOPE "1" "Version 1.2" "April 2001" "James McKenzie"
.SH NAME
nope \- Linux drivers for the Samsung yepp portable mp3 player
.SH SYNOPSIS
\fBnope\fR [\fIOPTION\fR] [\fIOPTION\fR]...
.SH DESCRIPTION
."
.PP 
nope provides open source drivers for the Samsung yepp, the driver can do everything the supplied software can - except format either the internal or the card memory. The program does some bad parallel port Voodoo with ECP capable ports, so you should probably disable ECP until you have tested it on a sync'd system. Having said that it hasn't crashed anything yet.
.PP
Files in the yepp are referenced by an index number. Index numbers less than 5 are reserved for special files. Files have a type (set by the user) and attributes which are set by the player. Nope makes no attempt to lock the port from access by Linux but does try to disable interrupts which may help if you have parport_pc loaded.
.PP 
with no arguments 
.B nope
establishes contact with the yepp and lists the contents of the player. Nope first
attempts to connect to player first using a quick algorithm which works if the player is already in "CONNECT" mode, failing that it resets the connection and takes
a few seconds to get connected. It is usual to get one or more failed messages. If you have trouble accessing the yepp, check you have the right parallel port and that your yepp isn't running out of juice.
.SH OPTIONS
.TP
\fB\-u\fR \fIfile\fR [\fItype\fR] 
Upload file to base memory in the yepp. If the type is omitted it is assumed to be mp3. (The base memory needs to have been formatted using other software)
.TP
\fB\-c\fR \fIfile\fR [\fItype\fR] 
Upload file to the memory card in the yepp. If the type is omitted it is assumed to be mp3. (The memory card needs to have been formatted using other software)
.TP
\fB\-d\fR \fInum\fR
Download the file with index number \fInum\fR, the filename is extracted from the yepp. This can be quite slow because ECP mode is not supported for downloading.
.TP
\fB\-e\fR \fInum\fR
Erase the file with index \fInum\fB.
.TP
\fB\-a\fR
Erase all files with index greater than 4. This effectively removes all user files from the Yepp.
.TP
\fB\-r\fR
Return control of the Yepp to user. This returns the yepp from "CONNECT" 
mode to the normal mode and re-enables auto power off. It is useful in scripts.
.TP
\fB\-p\fR \fIbase\fR
Set the io address of the parallel port to use. Nope requires at least a bi-directional parallel port to function, the yepp doesn't seem to support a nibble mode.
Nope probes for ports at 0x3bc, 0x378, and 0x278. If you supply an address nope just tries that one address. 
.SH Troubleshooting
.TP
Try again, try fresh batteries, check you are using the right parallel port, email me.
.SH AUTHOR
Written by James McKenzie <[e-mail]> and his cat.
.SH BUGS
.TP 
the \fB-c\fR and \fB-u\fR options should check for available space.
.TP 
nope should handle CTRL-C elegantly
.TP
Bad voodoo should be added for downloading as well as uploading.
.TP
Sometimes if you don't specify an order you get an unexpected one.
.SH WARNING
Nope uses very bad Voodoo to achieve download speeds of about 150kbps on ECP
capable parallel ports. There are super io chipsets which have trouble 
initializing in ECP mode and use of these may set fire to your goldfish etc.
I haven't been able to make it crash any systems yet - but be warned. If you
have trouble set the parallel port mode to EPP or bi-directional rather than 
ECP.
.SH "FUTHER WORK"
.PP 
nope needs some extra tools to convert sc4 and telephone files to other formats.
.SH COPYRIGHT
Copyright \(co 2001 James McKenzie.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH CREDITS
Thanks to Chris Lightfoot who suggested the name.
.SH "SEE ALSO"
http://gimel.esc.cam.ac.uk/james/nope