Skip to content

Software installation

rhn edited this page Aug 28, 2011 · 1 revision

To install jazda software, you need to build it and flash the microcontroller with it. There is no separate download of the binary file because every device should be separately calibrated.

Preparation

Calibration

The jazda project relies on AtMega8 builtin timer. According to the datasheets, it's not very precise, and its frequency varies with the temperature. Although jazda comes with a calibration value, it's recommended to measure it separately for every microcontroller.

The default value lives in src/preferences.h and is called ONE_SECOND. Its value tells the code how many timer tick events happen during one second.

You can adjust this value after you build your device by using the timer module for an extended period of time and comparing the time elapsed with a different, precise timer (e.g. GPS).

TODO: create an example program to help calculate calibration value.

Preferences

Jazda's preferences are stored in src/preferences.h - the preferences include pin choices, project options and module choices. It might prove useful to check that all the button/screen pins in this file correspond to the actual connections on the microcontroller (check datasheets to find out their names).

The most important part of the file is the last set of #defines. By changing them, you tell the project which functions you want to use. To disable a module, delete its line. Keep in mind that modules sometimes depend on each other and on other options.

For a complete explanation of all the switches, see preferences.

Building

To build jazda, you need to follow the general building instructions from building and then apply them to the file src/main.c.

After you flash your AtMega, you can plug it into the DIP socket. You're ready to go now!

Clone this wiki locally