File: README

package info (click to toggle)
simulavr 1.0.0%2Bgit20160221.e53413b-1
  • links: PTS
  • area: main
  • in suites: buster
  • size: 5,748 kB
  • sloc: cpp: 35,491; python: 6,991; ansic: 3,567; makefile: 1,072; sh: 653; asm: 414; tcl: 320
file content (92 lines) | stat: -rw-r--r-- 2,909 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
#
#  $Id$
#

Demonstrates the following Stimulation classes:

	o SpiSink - monitors the /SS, SCLK and MISO pins and prints
		each byte to stdout.

	o SpiSource - drives the /SS, SCLK and MOSI pins with data from
		the spidata file.

	o PinMonitor - monitors Port A Bit 0 and prints changes in its
		binary status to stdout.

	o AdcPin - Stimulates Port F Bit 0 with the values contained
		in the anadata file.

The AVR program alternately (every other byte) echoes the byte received
on the SPI or the ADCH value read from a recenet A/D converter, to the SPI.

The spidata file contains an HDLC encoded stream of *mostly* flags
that was used in my project at work. (We're running a form of
PPP/HDLC over SPI.)

The format of the spidata file consists of comments (lines
that start with a '#') and data lines. Each data line consists
of 3 values.

o First Value - the value (0 or non-zero)of /SS
o Second Value - the value (0 or non-zero) of SCLK
o Third Value - the value (0 or non-zero) of MOSI

When the SpiSource program stimulator reaches the end-of-file,
it rewinds and repeats ad-nauseum.

The anadata file contains analog data that that is read by the
AdcPin class and written to the Port F Bit 0 analog input of
the ATMega128.

The format of the anadata file consists of comments (lines
that start with a '#' character) and analog input lines.
Each input line consists of 2 values separated by whitespace.

o First Value - number of nano-seconds before the next value
	is read and applied to the analog input.
o Second Value - signed integer "analogValue" to be applied
	to the analog input.

To try it:

Step 1:
	Configure and build the simulavr (simulavr.so in particular)

Step 2:
	Build the AVR test program in this directory.
	$ make

Step 3:
	Run the test TCL script from this directory.
	$ check.tcl

Step 4:
	Marvel at the stdio activity.

Step 5:
	Try modifying the spidata file and see the results.


What you'll see on stdout:

Note: Comments added on the right.

spisink: /SS asserted		; SPI /SS goes LOW (printed by SpiSink)
spisink: 0x00				; 0x00 byte received on MISO from AVR (printed by SpiSink)
PORTA0: ASSERT				; Port A Bit 0 set low by AVR (printed by PinMonitor)
spisink: 0x00				; Analog Data from AVR on SPI MISO
spisink: 0x02				; echoed HDLC Data from AVR on SPI MISO
spisink: 0x99				; Analog data from AVR on SPI MISO
spisink: 0xD3				; echoed HDLC data from AVR on SPI MISO
spisink: 0x66				; Analog data from AVR on SPI MISO
spisink: 0x7E				; echoed HDLC data from AVR on SPI MISO
spisink: 0x33				; Analog data from AVR on SPI MISO
spisink: 0x7E				; echoed HDLC data from AVR on SPI MISO
...
...
spisink: 0x7E				; echoed HDLC data from AVR on SPI MISO
spisink: 0x04				; Analog data from AVR on SPI MISO
spisink: /SS negated		; SPI /SS goes HIGH (printed by SpiSink)
spisink: /SS asserted		; SPI /SS goes LOW (printed by SpiSink)
spisink: 0x7E				; echoed HDLC data