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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
//============================================================================
//
// SSSS tt lll lll
// SS SS tt ll ll
// SS tttttt eeee ll ll aaaa
// SSSS tt ee ee ll ll aa
// SS tt eeeeee ll ll aaaaa -- "An Atari 2600 VCS Emulator"
// SS SS tt ee ll ll aa aa
// SSSS ttt eeeee llll llll aaaaa
//
// Copyright (c) 1995-2007 by Bradford W. Mott and the Stella team
//
// See the file "license" for information on usage and redistribution of
// this file, and for a DISCLAIMER OF ALL WARRANTIES.
//
// $Id: AtariVox.hxx,v 1.7 2007/02/22 02:15:46 stephena Exp $
//============================================================================
#ifdef ATARIVOX_SUPPORT
#ifndef ATARIVOX_HXX
#define ATARIVOX_HXX
#include "Control.hxx"
#include "SpeakJet.hxx"
/**
Richard Hutchinson's AtariVox "controller": A speech synthesizer and
storage device.
This code owes a great debt to Alex Herbert's AtariVox documentation and
driver code.
@author B. Watson
@version $Id: AtariVox.hxx,v 1.7 2007/02/22 02:15:46 stephena Exp $
*/
class AtariVox : public Controller
{
public:
/**
Create a new AtariVox controller plugged into the specified jack
@param jack The jack the controller is plugged into
@param event The event object to use for events
*/
AtariVox(Jack jack, const Event& event);
/**
Destructor
*/
virtual ~AtariVox();
public:
/**
Read the value of the specified digital pin for this controller.
@param pin The pin of the controller jack to read
@return The state of the pin
*/
virtual bool read(DigitalPin pin);
/**
Read the resistance at the specified analog pin for this controller.
The returned value is the resistance measured in ohms.
The AtariVox doesn't use the analog pins.
@param pin The pin of the controller jack to read
@return The resistance at the specified pin
*/
virtual Int32 read(AnalogPin pin);
/**
Write the given value to the specified digital pin for this
controller. Writing is only allowed to the pins associated
with the PIA. Therefore you cannot write to pin six.
@param pin The pin of the controller jack to write to
@param value The value to write to the pin
*/
virtual void write(DigitalPin pin, bool value);
SpeakJet* getSpeakJet() { return mySpeakJet; }
private:
void clockDataIn(bool value);
void shiftIn(bool value);
private:
// How far off (in CPU cycles) can each write occur from when it's
// supposed to happen? Eventually, this will become a user-settable
// property... or it may turn out to be unnecessary.
enum { TIMING_SLOP = 0 };
// Instance of SpeakJet which will actually do the talking for us.
// In the future, we'll support both real and emulated SpeakJet
// chips; for now we only emulate it.
SpeakJet *mySpeakJet;
// State of the output pins
uInt8 myPinState;
// How many bits have been shifted into the shift register?
uInt8 myShiftCount;
// Shift register. Data comes in serially:
// 1 start bit, always 0
// 8 data bits, LSB first
// 1 stop bit, always 1
uInt16 myShiftRegister;
// When did the last data write start, in CPU cycles?
// The real SpeakJet chip reads data at 19200 bits/sec. Alex's
// driver code sends data at 62 CPU cycles per bit, which is
// "close enough".
uInt32 myLastDataWriteCycle;
};
#endif
#endif // ATARIVOX_SUPPORT