|
@ -41,15 +41,15 @@ Games |
|
|
Build |
|
|
Build |
|
|
===== |
|
|
===== |
|
|
|
|
|
|
|
|
Supported build platforms are Linux, FreeBSD and Windows (via Cygwin). Due to |
|
|
Supported build platforms are Linux, FreeBSD, NetBSD and Windows (via Cygwin). |
|
|
customized linker scripts, simulator support is currently limited to x86 and |
|
|
Due to customized linker scripts, simulator support is currently limited to x86 |
|
|
x86_64 archs. Following dependencies have to be met: |
|
|
and x86_64 archs. Following dependencies have to be met: |
|
|
|
|
|
|
|
|
Linux / FreeBSD |
|
|
Linux / FreeBSD / NetBSD |
|
|
--------------- |
|
|
------------------------ |
|
|
|
|
|
|
|
|
Package names are based on Debian/Ubuntu repositories. Please adapt the names |
|
|
Package names are based on Debian/Ubuntu repositories. Please adapt the names |
|
|
according to your Linux distribution (or FreeBSD for that matter). |
|
|
according to your Linux distribution (or BSD for that matter). |
|
|
|
|
|
|
|
|
* build-essential (pulls in an ordinary gcc build tool chain for the host) |
|
|
* build-essential (pulls in an ordinary gcc build tool chain for the host) |
|
|
* bc |
|
|
* bc |
|
@ -60,6 +60,7 @@ according to your Linux distribution (or FreeBSD for that matter). |
|
|
* binutils-avr |
|
|
* binutils-avr |
|
|
* avrdude |
|
|
* avrdude |
|
|
* freeglut3-dev |
|
|
* freeglut3-dev |
|
|
|
|
|
* bash (note to the BSD folks: bash is required for the config tool) |
|
|
|
|
|
|
|
|
Windows |
|
|
Windows |
|
|
------- |
|
|
------- |
|
@ -90,12 +91,21 @@ Configure |
|
|
Open a (Cygwin) terminal, change to your checkout directory and type: |
|
|
Open a (Cygwin) terminal, change to your checkout directory and type: |
|
|
> make menuconfig |
|
|
> make menuconfig |
|
|
|
|
|
|
|
|
This starts a curses based text interface for configuring certain aspects of |
|
|
In case you build on BSD, just use 'gmake' instead of 'make'. This starts an |
|
|
your target platform. Be careful if you use an IDE like Eclipse to manage the |
|
|
Ncurses based text interface for configuring certain aspects of your target |
|
|
build, as integrated terminal emulators tend to choke on curses generated shell |
|
|
platform. After a fresh checkout, the first thing you do is to load a profile |
|
|
output. Make sure that 'make menuconfig' has been run at least once in an |
|
|
with sane defaults. In the menuconfig interface, select 'Load a Default |
|
|
ordinary terminal emulator after a fresh checkout or after issuing 'make |
|
|
Configuration' and choose a preset. After hitting enter, the main menu returns |
|
|
mrproper'. |
|
|
immediately. You can either tune your configuration or just exit (choose 'Yes' |
|
|
|
|
|
at the confirmation dialog to save your stuff). |
|
|
|
|
|
|
|
|
|
|
|
Be careful if you use an IDE like Eclipse to manage the build, as |
|
|
|
|
|
integrated terminal emulators tend to choke on Ncurses generated output. |
|
|
|
|
|
Make sure that 'make menuconfig' has been run at least once in an ordinary |
|
|
|
|
|
terminal emulator after a fresh checkout or after issuing 'make mrproper'. |
|
|
|
|
|
|
|
|
|
|
|
Note: Always use 'make clean' after changing something in the menu, because |
|
|
|
|
|
subsequent builds may be broken if you don't. |
|
|
|
|
|
|
|
|
Compile |
|
|
Compile |
|
|
------- |
|
|
------- |
|
@ -103,11 +113,13 @@ Compile |
|
|
To build for the actual target platform, just type: |
|
|
To build for the actual target platform, just type: |
|
|
> make |
|
|
> make |
|
|
|
|
|
|
|
|
|
|
|
This yields an 'image.hex' file which you can flash to your AVR device. |
|
|
|
|
|
|
|
|
If you want to test and debug your code within a GUI application, you can use |
|
|
If you want to test and debug your code within a GUI application, you can use |
|
|
the simulator: |
|
|
the simulator: |
|
|
> make simulator |
|
|
> make simulator |
|
|
|
|
|
|
|
|
In case you build on FreeBSD, just use 'gmake' instead of 'make'. |
|
|
Again, use 'gmake' instead of 'make' on BSD. |
|
|
|
|
|
|
|
|
You can start the simulator by typing ./borgsim(.exe) |
|
|
You can start the simulator by typing ./borgsim(.exe) |
|
|
|
|
|
|
|
@ -116,8 +128,8 @@ Simulator Handling |
|
|
|
|
|
|
|
|
Please keep in mind that the simulator is NOT an emulator. All it does is |
|
|
Please keep in mind that the simulator is NOT an emulator. All it does is |
|
|
compile the source code to a native host application so you can step through |
|
|
compile the source code to a native host application so you can step through |
|
|
your C-Code. The GUI thread reads the simulated frame buffer every 40ms and |
|
|
your C-Code with an ordinary host debugger. The GUI thread reads the simulated |
|
|
draws its contents. |
|
|
frame buffer every 20ms (40ms on Windows) and draws its contents. |
|
|
|
|
|
|
|
|
Joystick directions are simulated by the WASD keys and SPACE acts as the fire |
|
|
Joystick directions are simulated by the WASD keys and SPACE acts as the fire |
|
|
button. The OpenGL based simulator (Linux/FreeBSD) enables you to adjust the |
|
|
button. The OpenGL based simulator (Linux/FreeBSD) enables you to adjust the |
|
|