x50ng/README.md

Additional note: August 22, 2013

Updated this so that it'll compile on Ubuntu 12.04.

--Nicholas Kirchner

Quick Start Guide
04/25/2010
Egan Ford <egan@sense.net>

NOTE: READ ALL INSTRUCTIONS

Prereqs:

* OS/X 10.6 64-bit:

  * Install X11, Xcode (from your installation media) in that order.
  * Install Macports (macports.org), then:

```
  sudo port install gtk2
  sudo port install pkgconfig
```

* Ubuntu 9.04 32-bit, 9.04 64-bit, 9.10 32-bit, 9.10 64-bit:

```
  sudo apt-get install libgtk2.0-dev
  sudo apt-get install subversion
```

* RedHat/CentOS 5.4 64-bit, Fedora 12 64-bit:

```
  sudo yum install subversion gtk2-devel
```

------------------------------------------------------------------------

Start up X11 and use xterm

------------------------------------------------------------------------

Download x49gp source:

```
svn co http://x49gp.svn.sourceforge.net/svnroot/x49gp x49gp
```

------------------------------------------------------------------------

Edit FIRMWARE (optional):

The default firmware will be 4950_92.bin, for HPGCC3 development copy
49_hpgcc.bin in to x49gp and change FIRMWARE in the Makefile.

------------------------------------------------------------------------

Build:

```
cd x49gp
make
make sdcard
make config
```

------------------------------------------------------------------------

Mount SD card:

OS/X:

```
open sdcard.dmg
```

Linux:

```
sudo mkdir -p /Volumes/X49GP/
sudo mount -o loop sdcard /Volumes/X49GP
```

------------------------------------------------------------------------

Put stuff in SD, e.g.:

OS/X:

```
cp BACKUP /Volumes/X49GP/
```

Linux:

```
sudo cp BACKUP /Volumes/X49GP/
```

NOTE:  If using HPGCC2 don't forget the the ARMToolbox.

------------------------------------------------------------------------

Eject SD:

OS/X:

```
hdiutil detach $(df | grep -i x49gp | head -1 | awk '{print $1}')
```

Linux:

```
sudo umount /Volumes/X49GP
```

------------------------------------------------------------------------

Run:

```
./x49gp config
```

------------------------------------------------------------------------

Do stuff, e.g.:

Restore backup:

```
BACKUP
3
->TAG
RESTORE
```

Install ARMToolbox (HPGCC2):

```
2
SETUP.BIN
3
->TAG
RCL
EVAL
```
(Right Click ON, Left Click C)

------------------------------------------------------------------------

To Exit Emulator

* ctrl-c to exit (from launch window)

------------------------------------------------------------------------

Start Over:

* clean slate?

```
rm -f flash-49g+ flash-50g flash-noboot sram s3c2410-sram
make flash-49g+ flash-50g flash-noboot sram s3c2410-sram
./newconfig
```

* soft reset only?

```
./newconfig
```

------------------------------------------------------------------------

Known Limitations:

* HPGCC SD Card I/O
  . libfsystem unavailable.
  . f* calls unstable (HPGCC2)
  . f* calls stable (HPGCC3)