UVISOR(4) BSD Kernel Interfaces Manual UVISOR(4)NAME
uvisor -- USB support for the PalmOS based PDAs
SYNOPSIS
To compile this driver into the kernel, place the following lines in your kernel configuration file:
device uvisor
device ucom
Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):
uvisor_load="YES"
DESCRIPTION
The uvisor driver provides support for USB based PalmOS PDAs, like Handspring Visor, Palm Mxxx series, and Sony Clie.
The device is accessed through the ucom(4) driver which makes it behave like a tty(4). The device has several ports for different purposes,
each of them gets its own ucom(4) device. The attach message describes the purpose of each port.
The usual Pilot tools can be used to access the attached device on the HotSync port.
HARDWARE
The uvisor driver supports the following devices:
o Aceeca Mez1000 RDA
o Handspring Treo
o Handspring Treo 600
o Handspring Visor
o Palm I705
o Palm M125
o Palm M130
o Palm M500
o Palm M505
o Palm M515
o Palm Tungsten T
o Palm Tungsten Z
o Palm Zire
o Palm Zire 31
o Sony Clie 4.0
o Sony Clie 4.1
o Sony Clie 5.0
o Sony Clie PEG-S500C
o Sony Clie NX60
o Sony Clie S360
o Sony Clie TJ37
SEE ALSO tty(4), ucom(4), usb(4)HISTORY
The uvisor driver was adopted from NetBSD 1.5 in August 2002. This manual page was adopted from NetBSD by Tom Rhodes <trhodes@FreeBSD.org>
at that time.
BUGS
The code to provide multiple ucom(4) instances has not yet been ported from NetBSD. It is unclear whether this driver works in its current
state.
BSD November 22, 2006 BSD
Check Out this Related Man Page
pnmtopalm(1) General Commands Manual pnmtopalm(1)NAME
pnmtopalm - convert a portable anymap into a Palm pixmap
SYNOPSIS
pnmtopalm [-verbose] [-depth N] [-maxdepth N] [-colormap] [-transparent color] [-offset]
[-rle-compression|-scanline-compression] [pnmfile]
DESCRIPTION
Reads a PNM image as input, from stdin or pnmfile. Produces a Palm pixmap as output.
Palm pixmap files are either greyscale files 1, 2, or 4 bits wide, or color files 8 bits wide, so pnmtopalm automatically scales colors to
have an appropriate maxval, unless you specify a depth or max depth. Input files must have an appropriate number and set of colors for the
selected output constraints. This often means that you should run the PNM image through ppmquant before you pass it to pnmtopalm. Netpbm
comes with several colormap files you can use with ppmquant for this purpose. They are palmgray2.map (4 shades of gray for a depth of 2),
palmgray4.map (16 shades of gray for a depth of 4), and palmcolor8.map (232 colors in default Palm colormap).
OPTIONS -verbose
Display the format of the output file.
-depth N
Produce a file of depth N, where N must be either 1, 2, 4, 8, or 16. Any depth greater than 1 will produce a version 1 or 2 bitmap.
Because the default Palm 8-bit colormap is not grayscale, if the input is a grayscale or monochrome pixmap, the output will never be
more than 4 bits deep, regardless of the specified depth. Note that 8-bit color works only in PalmOS 3.5 (and higher), and 16-bit
direct color works only in PalmOS 4.0 (and higher). However, the 16-bit direct color format is also compatible with the various
PalmOS 3.x versions used in the Handspring Visor, so these images may also work in that device.
-maxdepth N
Produce a file of minimal depth, but in any case less than N bits wide. If you specify 16-bit, the output will always be 16-bit
direct color.
-offset
Fill in the nextDepthOffset field in the file header, to provide for multiple renditions of the pixmap in the same file.
-colormap
Build a custom colormap and include it in the output file. This is not recommended by Palm, for efficiency reasons. Otherwise,
pnmtopalm uses the default Palm colormap for color output.
-transparent color
Marks one particular color as fully transparent. The format to specify the color is either (when for example orange) "1.0,0.5,0.0",
where the values are floats between zero and one, or with the syntax "#RGB", "#RRGGBB" or "#RRRRGGGGBBBB" where R, G and B are hexa-
decimal numbers. This also makes the output bitmap a version 2 bitmap. Transparency works only on Palm OS 3.5 and higher.
-rle-compression
Specifies that the output Palm bitmap will use the Palm RLE compression scheme, and will be a version 2 bitmap. RLE compression
works only with Palm OS 3.5 and higher.
-scanline-compression
Specifies that the output Palm bitmap will use the Palm scanline compression scheme, and will be a version 2 bitmap. Scanline com-
pression works only in Palm OS 2.0 and higher.
SEE ALSO palmtopnm(1), ppmquant(1), pnm(5)NOTES
An additional compression format, packbits, was added with PalmOS 4.0. This package should be updated to be able to generate that.
Palm pixmaps may contains multiple renditions of the same pixmap, in different depths. To construct an N-multiple-rendition Palm pixmap
with pnmtopalm, first construct renditions 1 through N-1 using the -offset option, then construct the Nth pixmap without the -offset
option. Then concatenate the individual renditions together in a single file using cat.
AUTHORS
This program was originally written as ppmtoTbmp.c, by Ian Goldberg and George Caswell. It was completely re-written by Bill Janssen to
add color, compression, and transparency function.
Copyright 1995-2001 by Ian Goldberg, George Caswell, and Bill Janssen.
7 December 2000 pnmtopalm(1)