Annotation of wikisrc/ports/hpcmips/howto-use.mdwn, revision 1.2

1.2     ! ryoon       1: [[!meta title="NetBSD/hpcmips User How-To page"]]
1.1       mspo        2: 
1.2     ! ryoon       3: [[!toc startlevel=1 levels=2]]
1.1       mspo        4: 
                      5: * * * * *
                      6: 
1.2     ! ryoon       7: ## About this page
1.1       mspo        8: 
                      9: This page contains information that current and potential users of
                     10: NetBSD/hpcmips can use to help them set up and maintain their systems.
                     11: 
                     12: * * * * *
                     13: 
1.2     ! ryoon      14: # Getting started with NetBSD/hpcmips
1.1       mspo       15: 
1.2     ! ryoon      16: ## Overview of how to start NetBSD/hpcmips
1.1       mspo       17: 
                     18: You need at least 2 files to start NetBSD/hpcmips:
                     19: 
1.2     ! ryoon      20: <dl>
        !            21: <dt>pbsdboot.exe</dt>
        !            22: <dd>
        !            23: bootloader runs on WindowsCE environment.
        !            24: </dd>
        !            25: <dt>a netbsd kernel</dt>
        !            26: </dl>
1.1       mspo       27: 
                     28: On pbsdboot pull-down menu, select hardware type and path to kernel.
                     29: pbsdboot passes hardware information (framebuffer information, etc.) to
                     30: kernel. The kernel will use all the Windows CE memory as RAM, so you
                     31: MUST backup all of your data stored in CE memory before booting. Click
                     32: Boot to load the kernel.
                     33: 
1.2     ! ryoon      34: ## filesystem overview
1.1       mspo       35: 
                     36: You have a choice of filesystems:
                     37: 
1.2     ! ryoon      38: <dl>
        !            39: <dt>filesystem on Compact Flash Cards or ATA Cards</dt>
        !            40: <dd>
        !            41: need a DOS partition for pbsdboot.exe and a NetBSD partition
        !            42: </dd>
        !            43: <dt>filesystem on SCSI/IDE disk</dt>
        !            44: <dd>
        !            45: NetBSD/hpcmips supports PCMCIA SCSI Card such as SlimSCSI, so you
        !            46: can make your file system on SCSI disks. Recommended for developers.
        !            47: </dd>
        !            48: <dt>filesystem on NFS Server</dt>
        !            49: <dd>
        !            50: During boot:<br />
        !            51: NetBSD/hpcmips finds pcmcia Ethernet Card<br />
        !            52: gets an IP address via dhcp server<br />
        !            53: finds NFS server<br />
        !            54: mounts / partition from NFS server
        !            55: </dd>
        !            56: </dl>
        !            57: 
        !            58: ## Do I need to purchase a CF or ATA card? If so - got any recommendations?
        !            59: 
        !            60: <dl>
        !            61: <dt>for typical users we recommend 128M CF.</dt>
        !            62: <dd>
        !            63: base+kern+etc+comp works fine
        !            64: </dd>
        !            65: <dt>80M-96M CF</dt>
        !            66: <dd>
        !            67: base+kern+etc - basic NetBSD system available in your pocket.
        !            68: </dd>
        !            69: <dt>less than 64M CF</dt>
        !            70: <dd>
        !            71: base+kern+etc - if you delete large unused files
        !            72: </dd>
        !            73: <dt>15M CF</dt>
        !            74: <dd>
        !            75: north pole for living - for those who like a challenge
        !            76: </dd>
        !            77: </dl>
1.1       mspo       78: 
1.2     ! ryoon      79: ## Finding out if your system is supported by NetBSD/hpcmips
1.1       mspo       80: 
1.2     ! ryoon      81: Check [[Supported Machines|supported_machines]] listing.
1.1       mspo       82: 
1.2     ! ryoon      83: ## Supported CF and PCMCIA cards
1.1       mspo       84: 
                     85: 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.
1.2     ! ryoon      86: See NetBSD [Machine-independent PCMCIA drivers](http://www.NetBSD.org/support/hardware/pcmcia.html).
1.1       mspo       87: 
1.2     ! ryoon      88: <dl>
        !            89: <dt>Compact Flash Storage:</dt>
        !            90: <dd>
        !            91: over 48M CF SanDisk<br />
        !            92: note:on z50 Extreme Memory Compact Flash EM-CF/128/P (PQI FLASH DISK
        !            93: 1201N)sometimes chokes and hangs the z50, especially under heavy
        !            94: "disk" load.
        !            95: </dd>
        !            96: <dt>PCMCIA Devices cards:</dt>
        !            97: <ul>
        !            98: <li>NE2000 compatible corega Ether PCC-T
        !            99: <li>3com 3C589*</li>
        !           100: <li>Lucent/Agere WaveLAN/Orinoco wireless NIC</li>
        !           101: <li>Socket Communications, Inc. Standard LP-E CF+ (EA2900-117)</li>
        !           102: <li>Xircom CF Ethernet card</li>
        !           103: <li><a href="http://www.tdk.co.jp/tjbda01/bda11100.htm">TDK LAC-CF010 CF Ethernet Card</a></li>
        !           104: <li>3com 3C1 : gets MAC address via ep driver, but does not transmit any packets. Broken.</li>
        !           105: <li>NTT DoCoMo Paldio 611S (Japan:PHS include CF Modem I/F)</li>
        !           106: <li><a href="http://www.linkease.com.tw/thing/dn_boy.htm">DN-boy</a></li>
        !           107: <li><a href="http://www.planex.co.jp/product/drive/rxindex.htm">eXtreme drive</a></li>
        !           108: </ul>
        !           109: <dd>
        !           110: <dt>Adaptec SlimSCSI 1460 (APA-1460)</dt>
        !           111: <dt>Apricorn EZ-GIG Expansion Card</dt>
        !           112: <dt>Callunacard CT260T2</dt>
        !           113: </dl>
1.1       mspo      114: 
1.2     ! ryoon     115: ## Getting the NetBSD/hpcmips distribution
1.1       mspo      116: 
1.2     ! ryoon     117: check <ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/>
1.1       mspo      118: 
1.2     ! ryoon     119:     binary/sets:NetBSD/hpcmips binary such as base.tgz, comp.tgz.
1.1       mspo      120:     installation:pbsdboot.exe.gz and netbsd.gz
                    121:     source:source files
                    122:     place pbsdboot.exe and netbsd on your CF card and run pbsdboot.exe
                    123:     to start netbsd installation kernel (includes sysinst). You can boot
                    124:     netbsd.gz without unzipping it if space is tight.
                    125: 
1.2     ! ryoon     126: ## Getting the NetBSD/hpcmips boot loader (pbsdboot.exe)
1.1       mspo      127: 
                    128: Download from [pbsdboot download
                    129: directory](ftp://ftp.NetBSD.org/pub/NetBSD/arch/hpcmips/pocketbsd/pbsdboot/).
                    130: Pbsdboot.exe is compiled for WindowsCE 2.00. Use Pbsdboot1.exe for
                    131: Windows CE 1.01. Pbsdboot.exe is updated to use color maps for 8 bit
                    132: frame buffer machines. Now we can use 256 colors, though we don't know
                    133: about details of video controller chip. (We actually do not know about
                    134: the video chips at all.)
                    135: 
                    136: Because Windows CE 1.0 does not support color map at all, the pbsdboot
                    137: can not support both CE 1.0 and 2.0 with single binary. Thus
                    138: pbsdboot.exe is compiled for CE 2.0 or later. You should use
                    139: pbsdboot1.exe for CE 1.0.
                    140: 
1.2     ! ryoon     141: ## Getting the NetBSD/hpcmips kernel
1.1       mspo      142: 
                    143: pbsdboot hook up NetBSD/hpcmips kernel file.
                    144: 
1.2     ! ryoon     145: * [netbsd-GENERIC.gz](ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/binary/kernel/):
        !           146: this kernel runs on Vr41xx and TX3922 CPUs only.
        !           147: * [netbsd-TX3912.gz](ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-5.0/hpcmips/binary/kernel/):
        !           148: a kernel for TX3912 machines.
1.1       mspo      149: 
1.2     ! ryoon     150: ## Accessing Microsoft partitions
1.1       mspo      151: 
                    152: To access your MS-DOS WinCE partition, read [Accessing Microsoft
1.2     ! ryoon     153: partitions](http://www.NetBSD.org/ports/i386/faq.html#ms_partition).
1.1       mspo      154: 
1.2     ! ryoon     155: ## Preparing a Compact Flash card with a NetBSD partition
1.1       mspo      156: 
1.2     ! ryoon     157: [Creating a file system on Compact Flash](http://www.NetBSD.org/ports/hpcmips/install.txt).
1.1       mspo      158: 
1.2     ! ryoon     159: ## Preparing a Compact Flash card without a NetBSD partition
1.1       mspo      160: 
                    161: TODO
                    162: 
1.2     ! ryoon     163: ## Getting support from mailing lists
1.1       mspo      164: 
                    165: -   [NetBSD/hpcmips mailing list (English
1.2     ! ryoon     166:     language)](http://www.NetBSD.org/mailinglists/#port-hpcmips)
1.1       mspo      167: -   [NetBSD/hpcmips mailing list (Japanese
                    168:     language)](http://www.jp.NetBSD.org/ja/JP/ml.html#port-hpcmips-ja)
                    169: 
1.2     ! ryoon     170: ## keyboard mapping control
1.1       mspo      171: 
1.2     ! ryoon     172: <dl>
        !           173: <dt>Swap CTRLCAPS</dt>
        !           174: <dd>
        !           175: wsconsctl -w encoding=jp.swapctrlcaps
        !           176: </dd>
        !           177: <dt>Muhenkan key to Function 10 (for MGL2 switch window)</dt>
        !           178: <dd>
        !           179: wsconsctl -w map+="keysym Muhenkan = F10"
        !           180: </dd>
        !           181: <dt>Henkan key to Function 9 (for MGL2 change window)</dt>
        !           182: <dd>
        !           183: wsconsctl -w map+="keysym Henkan = F9"
        !           184: </dd>
        !           185: </dl>
1.1       mspo      186: 
                    187: * * * * *
1.2     ! ryoon     188: # pbsdboot.exe: the NetBSD/hpcmips boot loader
1.1       mspo      189: 
1.2     ! ryoon     190: ## What is the NetBSD/hpcmips boot loader (pbsdboot.exe)?
1.1       mspo      191: 
                    192: TODO
                    193: 
1.2     ! ryoon     194: ## NetBSD/hpcmips boot loader options
1.1       mspo      195: 
1.2     ! ryoon     196: <dl>
        !           197: <dt>Boot loader from Windows CE</dt>
        !           198: <dd>
        !           199: Boot loader from Windows CE environment called "pbsdboot.exe" is
        !           200: available from
        !           201: [ftp.NetBSD.org](ftp://ftp.NetBSD.org/pub/NetBSD/arch/hpcmips/pocketbsd/pbsdboot/).
        !           202: </dd>
        !           203: <dt>Boot loader Options</dt>
        !           204: <dl>
        !           205: <dt><b>-d</b> break into the kernel debugger</dt>
        !           206: <dt><b>-m</b> use miniroot in memory</dt>
        !           207: <dt><b>-s</b> single user mode</dt>
        !           208: <dt><b>-h</b> use serial console</dt>
        !           209: <dt><b>-a</b> ask for name:kernel ask root device (such as wd0a), dump
        !           210: device (such as wd0b), filesystem (such as ffs). To change root
        !           211: device on Slim SCSI card/IDE PCMCIA card, use this option and set
        !           212: root device to sd0/wd.</dt>
        !           213: <dt><b>-b=DEV</b> change boot device to DEV(wd0, sd0, nfs etc.)</dt>
        !           214: </dl>
        !           215: </dd>
        !           216: </dl>
        !           217: 
        !           218: ## Booting the kernel with a serial console
        !           219: 
        !           220:     On pbsdboot, check & set these parameter:
        !           221:     Options: h
        !           222:     Serialport on
        !           223:     Connect your terminal with 9600bps, 8bit, non-parity, VT100 mode
        !           224:     pbsdboot frame buffer type setting
        !           225:     D8_FF : white type on black screen
        !           226:     D8_00 : black type on white screen
1.1       mspo      227: 
1.2     ! ryoon     228: ## Automatically booting into NetBSD
1.1       mspo      229: 
                    230: To skip touch panel calibration, power on with shift+power key. Some
                    231: systems will automatically run
1.2     ! ryoon     232: "`\Storage Card\AutoRun\XXXXXX\Autorun.exe`" where *`XXXXXX`*
1.1       mspo      233: is the CPU family. However, that isn't true for all systems. Also the
                    234: exact path is from memory and may be slightly incorrect.
                    235: 
1.2     ! ryoon     236: <dl>
        !           237: <dt>CASIO Cassiopeia:</dt>
        !           238: <dd>
        !           239: \CE\R4100\AutoRun.exe
        !           240: </dd>
        !           241: </dl>
1.1       mspo      242: 
1.2     ! ryoon     243: ## One-button boot on the Everex Freestyle
1.1       mspo      244: 
                    245: Everex Freestyle systems can be configured to start the boot loader at
                    246: the press of a button! To set up one-button boot loader invocation,
1.2     ! ryoon     247: place a copy of `pbsdboot.exe` in the root directory of an FAT
        !           248: file system on a compact flash, with the name `voiceapp.exe`.
1.1       mspo      249: 
                    250: To boot, just push the Freestyle "Record" button. PHILIPS Nino312 can
                    251: use this method.

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb