[[!meta title="NetBSD/hpcmips User How-To page"]]

[[!toc startlevel=1 levels=2]]

* * * * *

## About this page

This page contains information that current and potential users of
NetBSD/hpcmips can use to help them set up and maintain their systems.

* * * * *

# Getting started with NetBSD/hpcmips

## Overview of how to start NetBSD/hpcmips

You need at least 2 files to start NetBSD/hpcmips:

<dl>
<dt>pbsdboot.exe</dt>
<dd>
bootloader runs on WindowsCE environment.
</dd>
<dt>a netbsd kernel</dt>
</dl>

On pbsdboot pull-down menu, select hardware type and path to kernel.
pbsdboot passes hardware information (framebuffer information, etc.) to
kernel. The kernel will use all the Windows CE memory as RAM, so you
MUST backup all of your data stored in CE memory before booting. Click
Boot to load the kernel.

## filesystem overview

You have a choice of filesystems:

<dl>
<dt>filesystem on Compact Flash Cards or ATA Cards</dt>
<dd>
need a DOS partition for pbsdboot.exe and a NetBSD partition
</dd>
<dt>filesystem on SCSI/IDE disk</dt>
<dd>
NetBSD/hpcmips supports PCMCIA SCSI Card such as SlimSCSI, so you
can make your file system on SCSI disks. Recommended for developers.
</dd>
<dt>filesystem on NFS Server</dt>
<dd>
During boot:<br />
NetBSD/hpcmips finds pcmcia Ethernet Card<br />
gets an IP address via dhcp server<br />
finds NFS server<br />
mounts / partition from NFS server
</dd>
</dl>

## Do I need to purchase a CF or ATA card? If so - got any recommendations?

<dl>
<dt>for typical users we recommend 128M CF.</dt>
<dd>
base+kern+etc+comp works fine
</dd>
<dt>80M-96M CF</dt>
<dd>
base+kern+etc - basic NetBSD system available in your pocket.
</dd>
<dt>less than 64M CF</dt>
<dd>
base+kern+etc - if you delete large unused files
</dd>
<dt>15M CF</dt>
<dd>
north pole for living - for those who like a challenge
</dd>
</dl>

## Finding out if your system is supported by NetBSD/hpcmips

Check [[Supported Machines|supported_machines]] listing.

## Supported CF and PCMCIA cards

NetBSD [Supported hardware database](http://projects.NetBSD.org/cgi-bin/hw.cgi) is available. Select PCMCIA and query/add database. NetBSD users build this database.
See NetBSD [Machine-independent PCMCIA drivers](http://www.NetBSD.org/support/hardware/pcmcia.html).

<dl>
<dt>Compact Flash Storage:</dt>
<dd>
over 48M CF SanDisk<br />
note:on z50 Extreme Memory Compact Flash EM-CF/128/P (PQI FLASH DISK
1201N)sometimes chokes and hangs the z50, especially under heavy
"disk" load.
</dd>
<dt>PCMCIA Devices cards:</dt>
<ul>
<li>NE2000 compatible corega Ether PCC-T
<li>3com 3C589*</li>
<li>Lucent/Agere WaveLAN/Orinoco wireless NIC</li>
<li>Socket Communications, Inc. Standard LP-E CF+ (EA2900-117)</li>
<li>Xircom CF Ethernet card</li>
<li><a href="http://www.tdk.co.jp/tjbda01/bda11100.htm">TDK LAC-CF010 CF Ethernet Card</a></li>
<li>3com 3C1 : gets MAC address via ep driver, but does not transmit any packets. Broken.</li>
<li>NTT DoCoMo Paldio 611S (Japan:PHS include CF Modem I/F)</li>
<li><a href="http://www.linkease.com.tw/thing/dn_boy.htm">DN-boy</a></li>
<li><a href="http://www.planex.co.jp/product/drive/rxindex.htm">eXtreme drive</a></li>
</ul>
<dd>
<dt>Adaptec SlimSCSI 1460 (APA-1460)</dt>
<dt>Apricorn EZ-GIG Expansion Card</dt>
<dt>Callunacard CT260T2</dt>
</dl>

## Getting the NetBSD/hpcmips distribution

check <ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/>

    binary/sets:NetBSD/hpcmips binary such as base.tgz, comp.tgz.
    installation:pbsdboot.exe.gz and netbsd.gz
    source:source files
    place pbsdboot.exe and netbsd on your CF card and run pbsdboot.exe
    to start netbsd installation kernel (includes sysinst). You can boot
    netbsd.gz without unzipping it if space is tight.

## Getting the NetBSD/hpcmips boot loader (pbsdboot.exe)

Download from [pbsdboot download
directory](ftp://ftp.NetBSD.org/pub/NetBSD/arch/hpcmips/pocketbsd/pbsdboot/).
Pbsdboot.exe is compiled for WindowsCE 2.00. Use Pbsdboot1.exe for
Windows CE 1.01. Pbsdboot.exe is updated to use color maps for 8 bit
frame buffer machines. Now we can use 256 colors, though we don't know
about details of video controller chip. (We actually do not know about
the video chips at all.)

Because Windows CE 1.0 does not support color map at all, the pbsdboot
can not support both CE 1.0 and 2.0 with single binary. Thus
pbsdboot.exe is compiled for CE 2.0 or later. You should use
pbsdboot1.exe for CE 1.0.

## Getting the NetBSD/hpcmips kernel

pbsdboot hook up NetBSD/hpcmips kernel file.

* [netbsd-GENERIC.gz](ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/binary/kernel/):
this kernel runs on Vr41xx and TX3922 CPUs only.
* [netbsd-TX3912.gz](ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/binary/kernel/):
a kernel for TX3912 machines.

## Accessing Microsoft partitions

To access your MS-DOS WinCE partition, read [Accessing Microsoft
partitions](http://www.NetBSD.org/ports/i386/faq.html#ms_partition).

## Preparing a Compact Flash card with a NetBSD partition

[Creating a file system on Compact Flash](http://www.NetBSD.org/ports/hpcmips/install.txt).

## Preparing a Compact Flash card without a NetBSD partition

TODO

## Getting support from mailing lists

-   [NetBSD/hpcmips mailing list (English
    language)](http://www.NetBSD.org/mailinglists/#port-hpcmips)
-   [NetBSD/hpcmips mailing list (Japanese
    language)](http://www.jp.NetBSD.org/ja/JP/ml.html#port-hpcmips-ja)

## keyboard mapping control

<dl>
<dt>Swap CTRLCAPS</dt>
<dd>
wsconsctl -w encoding=jp.swapctrlcaps
</dd>
<dt>Muhenkan key to Function 10 (for MGL2 switch window)</dt>
<dd>
wsconsctl -w map+="keysym Muhenkan = F10"
</dd>
<dt>Henkan key to Function 9 (for MGL2 change window)</dt>
<dd>
wsconsctl -w map+="keysym Henkan = F9"
</dd>
</dl>

* * * * *
# pbsdboot.exe: the NetBSD/hpcmips boot loader

## What is the NetBSD/hpcmips boot loader (pbsdboot.exe)?

TODO

## NetBSD/hpcmips boot loader options

<dl>
<dt>Boot loader from Windows CE</dt>
<dd>
Boot loader from Windows CE environment called "pbsdboot.exe" is
available from
[ftp.NetBSD.org](ftp://ftp.NetBSD.org/pub/NetBSD/arch/hpcmips/pocketbsd/pbsdboot/).
</dd>
<dt>Boot loader Options</dt>
<dl>
<dt><b>-d</b> break into the kernel debugger</dt>
<dt><b>-m</b> use miniroot in memory</dt>
<dt><b>-s</b> single user mode</dt>
<dt><b>-h</b> use serial console</dt>
<dt><b>-a</b> ask for name:kernel ask root device (such as wd0a), dump
device (such as wd0b), filesystem (such as ffs). To change root
device on Slim SCSI card/IDE PCMCIA card, use this option and set
root device to sd0/wd.</dt>
<dt><b>-b=DEV</b> change boot device to DEV(wd0, sd0, nfs etc.)</dt>
</dl>
</dd>
</dl>

## Booting the kernel with a serial console

    On pbsdboot, check & set these parameter:
    Options: h
    Serialport on
    Connect your terminal with 9600bps, 8bit, non-parity, VT100 mode
    pbsdboot frame buffer type setting
    D8_FF : white type on black screen
    D8_00 : black type on white screen

## Automatically booting into NetBSD

To skip touch panel calibration, power on with shift+power key. Some
systems will automatically run
"`\Storage Card\AutoRun\XXXXXX\Autorun.exe`" where *`XXXXXX`*
is the CPU family. However, that isn't true for all systems. Also the
exact path is from memory and may be slightly incorrect.

<dl>
<dt>CASIO Cassiopeia:</dt>
<dd>
\CE\R4100\AutoRun.exe
</dd>
</dl>

## One-button boot on the Everex Freestyle

Everex Freestyle systems can be configured to start the boot loader at
the press of a button! To set up one-button boot loader invocation,
place a copy of `pbsdboot.exe` in the root directory of an FAT
file system on a compact flash, with the name `voiceapp.exe`.

To boot, just push the Freestyle "Record" button. PHILIPS Nino312 can
use this method.