22
21
* along with this program. If not, see <http://www.gnu.org/licenses/>.
25
/******************************************************************************
29
* a PC fan is wired up to a 12V power supply
31
* the fan's SENSE (tachometer) pin connected to pin 2 on the
34
* the pins 4 to 13 on the Arduino should directly drive an LED (the
35
LED on pin 4 is in the centre of the clock face and the LED on pin
38
* if a longer hand (and a larger clock face) is desired, pin 4 can be
39
used to indirectly drive a transistor which in turn drives several
40
LEDs that turn on and off in unison in the centre of the clock.
42
* a button should be attached to pin 3 that grounds it when pressed.
44
* A DS1307 remote clock is connected via I2C on analogue pins 4 and 5.
46
Implementation details:
48
* for a schematic, see ../project/propeller-clock.sch.
50
* the timing of the drawing of the clock face is recalculated with
51
every rotation of the propeller.
53
* a PC fan actually sends 2 tachometer pulses per revolution, so the
54
software skips every other one. This means that the clock may
55
appear upside-down if started with the propeller in the wrong
56
position. You will need to experiment to discover the position that
57
the propeller must be in when starting the clock.
61
* pressing the button cycles between variations of the current
64
* pressing and holding the button for a second cycles between display
65
modes (e.g., analogue and digital).
67
* pressing and holding the button for 5 seconds enters "time set"
68
mode. In this mode, the following applies:
69
- the field that is being set flashes
70
- pressing the button increments the field currently being set
71
- pressing and holding the button for a second cycles through the
72
fields that can be set
73
- pressing and holding the button for 5 seconds sets the time and
76
******************************************************************************/
82
#include "analogue_clock.h"
83
#include "digital_clock.h"
84
#include "test_pattern.h"
85
#include "settings_mode.h"
87
#include "text_renderer.h"
90
24
//_____________________________________________________________________________
93
28
// when non-zero, the time (in microseconds) of a new fan pulse that
94
29
// has just occurred, which means that segment drawing needs to be
96
static unsigned long _new_pulse_at = 0;
31
static unsigned long new_pulse_at = 0;
98
33
// the time (in microseconds) when the last fan pulse occurred
99
static unsigned long _last_pulse_at = 0;
34
static unsigned long last_pulse_at = 0;
101
36
// duration (in microseconds) that a segment should be displayed
102
static unsigned long _segment_step = 0;
37
static unsigned long segment_step = 0;
104
39
// remainder after divisor and a tally of the remainders for each segment
105
static unsigned long _segment_step_sub_step = 0;
106
static unsigned long _segment_step_sub = 0;
109
static Button _button( 3 );
112
static int _major_mode = 0;
113
static int _minor_mode = 0;
115
#define MAIN_MODE_IDX 1
116
#define SETTINGS_MODE_IDX 0
118
#define ANALOGUE_CLOCK_IDX 0
119
#define DIGITAL_CLOCK_IDX 1
120
#define TEST_PATTERN_IDX 2
40
static unsigned long segment_step_sub_step = 0;
41
static unsigned long segment_step_sub = 0;
122
47
//_____________________________________________________________________________
126
// activate the current minor mode
127
void activate_minor_mode()
133
// give the mode a chance to init
134
switch( _minor_mode ) {
135
case ANALOGUE_CLOCK_IDX: analogue_clock_activate(); break;
136
case DIGITAL_CLOCK_IDX: digital_clock_activate(); break;
141
// activate major mode
142
void activate_major_mode()
148
// give the mode a chance to init
149
switch( _major_mode ) {
150
case MAIN_MODE_IDX: activate_minor_mode(); break;
151
case SETTINGS_MODE_IDX: settings_mode_activate(); break;
156
// perform button events
157
void do_button_events()
159
// loop through pending events
160
while( int event = _button.get_event() )
51
// ISR to handle the pulses from the fan's tachiometer
52
void fanPulseHandler()
54
// the fan actually sends two pulses per revolution. These pulses
55
// may not be exactly evenly distributed around the rotation, so
56
// we can't recalculate times on every pulse. Instead, we ignore
57
// every other pulse so timings are based on a complete rotation.
58
static bool ignore = true;
166
switch( _major_mode ) {
168
switch( _minor_mode ) {
169
case ANALOGUE_CLOCK_IDX: analogue_clock_press(); break;
170
case DIGITAL_CLOCK_IDX: digital_clock_press(); break;
173
case SETTINGS_MODE_IDX: settings_mode_press(); break;
179
switch( _major_mode ) {
181
if( ++_minor_mode >= 3 )
183
activate_minor_mode();
185
case SETTINGS_MODE_IDX: settings_mode_long_press(); break;
190
// looooong press (change major mode)
191
if( ++_major_mode > 1 )
193
activate_major_mode();
62
// set a new pulse time
63
new_pulse_at = micros();
200
// draw a display segment
201
void draw_next_segment( bool reset )
68
// draw a particular segment
69
void drawNextSegment( bool reset )
203
// keep track of segment
205
static int segment = ( NUM_SEGMENTS - CLOCK_SHIFT ) % NUM_SEGMENTS;
206
if( reset ) segment = ( NUM_SEGMENTS - CLOCK_SHIFT ) % NUM_SEGMENTS;
208
static int segment = NUM_SEGMENTS - 1 - CLOCK_SHIFT;
209
if( reset ) segment = NUM_SEGMENTS - 1 - CLOCK_SHIFT;
212
// reset the text renderer
213
TextRenderer::reset_buffer();
217
switch( _major_mode ) {
219
switch( _minor_mode ) {
220
case ANALOGUE_CLOCK_IDX: analogue_clock_draw_reset(); break;
221
case DIGITAL_CLOCK_IDX: digital_clock_draw_reset(); break;
224
case SETTINGS_MODE_IDX: settings_mode_draw_reset(); break;
227
// tell the text services we're starting a new frame
232
switch( _major_mode ) {
234
switch( _minor_mode ) {
235
case ANALOGUE_CLOCK_IDX: analogue_clock_draw( segment ); break;
236
case DIGITAL_CLOCK_IDX: digital_clock_draw( segment ); break;
237
case TEST_PATTERN_IDX: test_pattern_draw( segment ); break;
240
case SETTINGS_MODE_IDX: settings_mode_draw( segment ); break;
243
// draw any text that was rendered
244
TextRenderer::output_buffer();
247
if( ++segment >= NUM_SEGMENTS ) segment = 0;
249
if( --segment < 0 ) segment = NUM_SEGMENTS - 1;
71
static unsigned int segment = 0;
72
if( reset ) segment = 0;
75
for( int a = 0; a < 10; a++ )
76
digitalWrite( a + 4, ( ( segment >> a ) & 1 )? HIGH : LOW );
254
80
// calculate time constants when a new pulse has occurred
255
void calculate_segment_times()
81
void calculateSegmentTimes()
257
83
// check for overflows, and only recalculate times if there isn't
258
84
// one (if there is, we'll just go with the last pulse's times)
259
if( _new_pulse_at > _last_pulse_at )
85
if( new_pulse_at > last_pulse_at )
261
87
// new segment stepping times
262
unsigned long delta = _new_pulse_at - _last_pulse_at;
263
_segment_step = delta / NUM_SEGMENTS;
264
_segment_step_sub = 0;
265
_segment_step_sub_step = delta % NUM_SEGMENTS;
88
unsigned long delta = new_pulse_at - last_pulse_at;
89
segment_step = delta / NUM_SEGMENTS;
91
segment_step_sub_step = delta % NUM_SEGMENTS;
268
94
// now we have dealt with this pulse, save the pulse time and
269
95
// clear new_pulse_at, ready for the next pulse
270
_last_pulse_at = _new_pulse_at;
96
last_pulse_at = new_pulse_at;
275
101
// wait until it is time to draw the next segment or a new pulse has
277
void wait_till_end_of_segment( bool reset )
103
void waitTillNextSegment( bool reset )
279
105
static unsigned long end_time = 0;
283
end_time = _last_pulse_at;
109
end_time = last_pulse_at;
285
111
// work out the time that this segment should be displayed until
286
end_time += _segment_step;
287
_segment_step_sub += _segment_step_sub_step;
288
if( _segment_step_sub >= NUM_SEGMENTS ) {
289
_segment_step_sub -= NUM_SEGMENTS;
112
end_time += segment_step;
113
semgment_step_sub += semgment_step_sub_step;
114
if( semgment_step_sub >= NUM_SEGMENTS ) {
115
semgment_step_sub -= NUM_SEGMENTS;
294
while( micros() < end_time && !_new_pulse_at );
298
// ISR to handle the pulses from the fan's tachiometer
299
void fan_pulse_handler()
301
// the fan actually sends two pulses per revolution. These pulses
302
// may not be exactly evenly distributed around the rotation, so
303
// we can't recalculate times on every pulse. Instead, we ignore
304
// every other pulse so timings are based on a complete rotation.
305
static bool ignore = true;
309
// set a new pulse time
310
_new_pulse_at = micros();
120
while( micros() < end_time && !new_pulse_at );