# How to install NetBSD/emips-current to Microsoft Giano

See: <http://www.netbsd.org/ports/emips/NetBsd_excerpt.htm>

[Japanese version](http://ryo-on.users.sourceforge.net/distrib/20110205-NetBSD-emips-on-giano.txt)

## Requirements
* Microsoft Windows XP SP3 Home (32 bit) (for example)
* some hard drive space

## How to get softwares
### Microsoft Giano
At 2011-02-04, Microsoft Giano Version 3.1 is latest.
Download *giano.msi* file from <http://research.microsoft.com/en-us/downloads/02e2edbf-c76c-47d5-b9c0-2c9915c63e98/default.aspx>
or <http://research.microsoft.com/en-us/downloads>.


### How to get iso image file
Download *emipscd.iso* from <http://nyftp.netbsd.org/pub/NetBSD-daily/HEAD/>
or <http://ftp.jaist.ac.jp/pub/NetBSD-daily/HEAD/>

ftp.jaist.ac.jp is suitable for people in Japan

Recently the ISO image is named as NetBSD-7.99.25-emips.iso or so.
Be sure to rename it to emipscd.iso.

### How to get and select PuTTY
Download *putty.exe* from <http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html>.
Old PuTTY does not support serial connection.
Please use latest version.

If you want to use Japanese locale, please use "PuTTY Gottani-ban 0.60", for example.
You can download it from <http://yebisuya.dip.jp/Software/PuTTY/>.


## Preparing
### Installing Giano
Follow installer's instruction.
You can install Giano under *C:\Program Files*.


### Preparing space for emulated machine
Make c:\emul\NetBSD-emips-current directory.

#### Copying files to c:\emul\NetBSD-emips-current directory
There is following 3 files in c:\Program Files\Microsoft Research\Microsoft Giano\tests\eMIPS directory.

* boot.emips
* Ml40x_2ace.plx
* Ml40x_bram.bin.

Please copy them to c:\emul\NetBSD-emips-current.

And downloaded *emipscd.iso* file should be copied to c:\emul\NetBSD-emips-current.
Latest boot.emips is included in *emipscd.iso*. If you can, please use it.

#### Creating target disk image
If you have installed cygwin or UnxUtils.
You can simply use dd command.

Alternatively if you have large files (for example emipscd.iso),
You can make target disk image from them.

I do not know target image file should be started by boot.emips or not.

Name of the target disk image is *emips3.img*.

	> cd /d c:\emul\NetBSD-emips-current
	> copy /bin boot.emips + \somewhere\somethins.img emips3.img


### Setting up PuTTY
Select *Connection Type* as *Serial*.
Input *Serial line* to *\\\\.\pipe\usart0*
Save this setting to "Saved Sessions".


## Start emulator machine
### Start Giano
	> cd /d c:\emul\NetBSD-emips-current
	> "c:\Program Files\Microsoft Research\Microsoft Giano\bin\giano.exe" -Platform Ml40x_2ace.plx
If you see "Access to a non-existent memory" dialog box here. You can simply "Ignore" it.


### Start PuTTY
Start PuTTY and connect to **\\\\.\pipe\usart0**.
And click *Retry* in the dialog box.


### Boot from NetBSD/emips iso image
If you see

	NetBSD/emips 5.99.45
	Default: 0/ace(0,0)/netbsd
	boot: 

then input

	boot: 0/ace(1,0)/netbsd
	      ~~~~~~~~~~~~~~~~~

Please select vt110 as terminal type.
And sysinst is started.


### Installing NetBSD/emips
Please install NetBSD.
See <http://www.netbsd.org/docs/guide/en/index.html>.

This process consumes your time.


## Supplementary
### Networking
Network device is identified as enic0

	# ifconfig enic0 inet 192.168.0.200 netmask 0xffffff00


### single user mode
	boot: 0/ace(1,0)/netbsd -s
	      ~~~~~~~~~~~~~~~~~~~~

### Clock
It seems that RTC_OFFSET in kernel config file is not needed.
RTC is not accurate.

## homework
* This document does not contain instruction about acceleration.
* Fix boot.