AVR Emulator

The AVR Emulator may be used to test code without the QUTy development board. It supports all hardware peripherals used in EGB202 and can be configured with custom emulator events and arguments.

Project Templates
Events
1. UART Output
Arguments
1. Immediate Termination

Project Templates

Use the following ZIP files to test the AVR Emulator with custom events and arguments.

Events

File: events.txt

Events specify the actions that the emulator should take at specific times during the simulation. Each event must be specified on a new line and take the form:

@time component: argument

where:

time is a count of nanoseconds since the start of the simulation, in hexadecimal (no prefix).
component is the name of the component of interest.
argument is some action or value to be applied to the component.

On the QUTy, the following components and actions are supported:

UART Transmit (U5)
```
@time U5: data
```
where data is the byte to be transmitted, in hexadecimal (no prefix).
Pushbutton Press (Sn)
```
@time Sn: PRESS
```
where 1 <= n <= 4 indicates the button being pressed.
Pushbutton Release (Sn)
```
@time Sn: RELEASE
```
where 1 <= n <= 4 indicates the button being released.
Potentiometer Position (R1)
```
@time R1: position
```
where position is the position of the potentiometer, as a floating-point number, ranging from 0 to 1.

UART Output

If the user expects UART output from the program, the UART buffer should be flushed before the end of the simulation.

@time U5: flush

Arguments

File: arguments.txt

Emulator arguments are used to specify the behaviour of the AVR Emulator executable at the end of the simulation. All arguments and their values must be supplied on a new line.

The following arguments are supported:

Timeout (-t or --timeout): Specify the emulation runtime limit in nanoseconds, as a decimal value.
```
-t
1000000000
```
Dump Stack (-s or --dump-stack): Dump the stack to stdout on termination.
```
-s
```
Dump Registers (-r or --dump-regs): Dump working register values to stdout on termination.
```
-r
```
Dump stdout (-o or --dump-stdout): Dump the output of stdout to the file stdout.txt on termination.
```
-o
```
Debug (-d or --debug): Enable debug output.
```
-d
```

Immediate Termination

If the user is unsure of the time at which the program will terminate, they should specify a large timeout and include the break instruction in their code. This will cause the emulator to terminate early.

In Assembly:

break

In C:

asm("break");

Note that this may result in the UART buffer not being flushed.