Warning! This tutorial is seriously out-of-date and will not compile on the latest Uzebox software. Check the WIKI for examples and other tutorials.
Software Requirements
The following software is required:
-
AVR Studio: Atmel free IDE for developing with AVR devices.
-
WinAVR: WinAVR is required to program in C with GCC.
-
Eclipse: Required to use the tools coded in Java.
-
The Uzebox kernel files from the download section.
The following software are optional but highly useful in making games:
-
A graphic edition program like Photoshop or The Gimp to make tiles, sprites, etc.
-
A MIDI capable music program like Sonar, Cubase or open source equivalents to compose your game's music.
Getting started
Here's a quick and dirty tutorial on how to display the classic Hello World on the Uzebox.
- Start AVR Studio and select Project->New Project. Select AVR GCC as new project type and name your project HelloWorld.
- In the next dialog select the simulator as your debug platform and select the ATmega644 as the device. Click finish.
-
Select Project->Configuration Options and uncheck box the named "Unsigned chars". Set the optimization to -Os. Click Ok.
- Unzip the Uzebox files where you created the project.
- Add the kernel files to the project: Right "Source Files" in the left pane and select "Add existing source files...". Now add
all the files in the kernel sub-folder.
- Edit the HelloWorld.c file and add the following code to it
#include <avr/io.h>
#include <stdlib.h>
#include <avr/pgmspace.h>
#include "kernel/video.h"
#include "data/fonts.pic.inc"
const char strHello[] PROGMEM ="HELLO WORLD FROM THE UZEBOX!";
int main(){
SetFontTable(fonts);
ClearVram();
Print(8,12,strHello);
while(1);
}
-
Press F7 to build the project.
-
From the toolbar, click the button named "Connect to the select AVR Programmer". The following pop-up comes up. Select the location of the .hex file (usually under [your project dir]/default).
-
Click "Program"!
-
Enjoy!
