Ylink usage
ylink: Yampp MP3 player link tool, version 0.9.6
Copyright (c) 2003 Jim Peters <http://uazu.net/>,
-2005 Roger Nilsson <http://nilrog.homeip.net/nilrog/>,
all rights reserved.
Released under the GNU GPL version 2; see file COPYING for details.
See http://uazu.net/yampp/ or http://nilrog.homeip.net/nilrog/ for latest ylink
version, and http://yampp.com/ for details of Yampp hardware, firmware and
other Yampp-related software.
Transport layer:
RdWr *nix USB - Version 0.76 / Nov 29 2005 / 06:38:13
Usage: ylink [global options] <command> [options] [ : ... ]
Global options:
-c Enable cacheing
-d <name> Use device instead of /dev/cu.usbserial-1B1
-g <on|off> GUI-mode, specially formatted printouts and
argument reading from stdin
'on': Progress output is enabled
'off': Progress output is disabled
(Using this option also includes all things from
option '-s')
-m Measure transfer speed
-s Send command arguments to stdin
-t <access-method> Use to access the YADL-data
'usb': Use standard USB access
'disk': Use direct disk access
'file': Use file access
-v Verbose
Options:
-o Override certain default command settings
Simple commands:
: Command separator, to execute several commands in one go
ping Check that the yampp is on and working; also useful to
return it to normal operation after a command failure
dir List all the songs on the yampp
If '-g' is specified printouts are tab-separated
free Display FAT usage
put [012] <file> ... Write one or more MP3 files onto the player
[012] Is the order for ylink when parsing the songs
for Artist/Title information (default: 120)
0: Read from filename
1: - " - ID3v1 tag
2: - " - ID3v2 tag
(unless '-o' is specified a song can only be uploaded
once to the player)
If '-g' or '-s' is specified you can send the
filenames to stdin separated by '\n' and stop
with EOF
If '-g' is specified printouts are tab-separated
get <num> ... Read one or more songs from the player into the current
directory by their song numbers
If '-g' or '-s' is specified you can send the
songnumbers to stdin separated by '\n' and stop
with EOF
del <num> Delete one or more songs from the player by song number
If '-g' or '-s' is specified you can send the
songnumbers to stdin separated by '\n' and stop
with EOF
pldir List all playlists on the yampp
If '-g' is specified printouts are tab-separated
plget Read the playlists into 'playlist.txt' for editing
If '-g' is specified printouts are tab-separated and
printed to stdout
plput Write the data from 'playlist.txt' back to the player
If '-g' or '-s' is specified it reads the playlist
from stdin in the same format and stops when EOF is
found
format [num] <name> Format the player disk in YADL format with the given
name; requires that the firmware has already filled
in the root sector
[num] If '-o' is specified you can supply the number
of songbase entries to create on the disk
eqput <file> Write equalizer-file to player
If wasteland space is too small automatic expansion
will take place, if it is not already extended.
If '-o' is specified the expansion will take place
even if last FAT is marked 'invalid'
NOTE: This *may* destroy your data!
eqclr Remove equalizer from disk
put-logo <pos> Write logo to player/card
If '-o' is specified the image is inverted
clr-logo <pos> Clear logo from player/card
<pos> Specifies which logo to put/clear
card: Change logo on card
player: - " - player
pack-color-bmp Packs all the bitmaps for use with yampp color LCD
together into one bin-file that can be uploaded to
the player
put-color-bmp <file> Write color bitmap-file to player
If wasteland space is too small automatic expansion
will take place, if it is not already extended.
If '-o' is specified the expansion will take place
even if last FAT is marked 'invalid'
NOTE: This *may* destroy your data!
put-colorchar <file> Write color character file to player
put-natchar <file> Write national character file to player
upload-file <file> Upload ylf-file to player
NOTE: You may destroy your data with this command!
There are no security checks done before
uploading the file according to the information
in the ylf-file
Advanced commands:
info Dump out the player's root sector information
dump Dump out the root sector, songbase, FAT and playlist
information in full, for debugging
If '-o' is specified the playlist is not dumped
zeroroot Zeros the disk root sector. This forces the yampp
firmware to reinitialise the root sector. This can
be used before a 'format' to completely reinitialise
the disk from scratch
backup <filename> Make a backup of the filesystem sectors
restore <filename> Write a backup-file back to the player
NOTE: This *may* destroy your data!
upload-fw <bin-file> Upload new firmware to yampp player
Firmware maximum size:
0x3C00 bytes, Bootloader version less than 5
0x3F00 bytes, Bootloader version 5 or higher
If '-o' is specified no firmware size check is done
yboot-ping Ping used when in yboot mode
yboot-esc Exit from yboot mode, i.e. boot firmware
