x49gp/README.md
claudiol 066af08ae5 On behalf of:3298
Merge remote-tracking branch 'datajerk/master'
2018-05-07 17:26:44 -04:00

188 lines
2.9 KiB
Markdown

Quick Start Guide
03/27/2017
Egan Ford <egan@sense.net>
NOTE: READ ALL INSTRUCTIONS
Prereqs:
* MacOS 10.12 64-bit:
* Install XQuartz, Xcode (from your installation media) in that order.
* Install Macports (macports.org), then:
```
sudo port install gtk2 pkgconfig gcc6
sudo port select --set gcc mp-gcc6
export PATH=/opt/local/bin:$PATH
```
* Ubuntu:
```
sudo apt-get install git libgtk2.0-dev
```
* RedHat/CentOS, Fedora:
```
sudo yum install git gtk2-devel
```
------------------------------------------------------------------------
Start up X11 and use xterm
------------------------------------------------------------------------
Download x49gp source:
```
git clone https://github.com/chwdt/x49gp.git
```
------------------------------------------------------------------------
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 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)
------------------------------------------------------------------------
Change Log:
Additional note: August 22, 2013
Updated this so that it'll compile on Ubuntu 12.04.
--Nicholas Kirchner