Initial Commit
[simavr] / README
1
2 simavr -- a simple, lean and mean AVR simulator
3
4 http://gitorious.org/simavr
5
6 simavr is a new AVR simulator for linux, or any platform that uses avr-gcc. It uses 
7 avr-gcc own register definition to simplify creating new targets for supoortted AVR
8 devices.
9
10 The core was made to be small and compact, and hackable so allow quick protoyping 
11 of an AVR project. The simulator loads .elf directly, and there is even a way to
12 specify simulation parameters directly in the emulated code using an .elf section.
13
14 The status of the project is the core works at about 98% (ie, it works, but there 
15 is a known bug). The supported IOs are eeprom, IO ports (including pin interupts), 
16 8 bits timers (well, one of mode of the myriad) and a simple UART that makes 
17 ÒprintfÓ work.
18
19 gdb support is planned next.
20
21 PREQUISTES:
22 + avr-gcc ; tested with 4.3.4 (from debian)
23         The code rudely assumes the avr-gcc is in /usr/lib/avr/include/...
24 + libelf-dev
25
26 BUILD:
27 + make
28
29 TEST:
30 + ./simavr/simavr tests/atmega88_example.axf
31
32 There are no command line options for now.. The simulator recognizes attiny85, 
33 atmega48,88,168 and atmega644. It's fairly easy to add new cores.
34
35 Michel Pollet <buserror@gmail.com>