29
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
31
* the fan's SENSE (tachiometer) pin connected to pin 2 on the
34
* the pins 4 to 13 on the Arduino should directly drive an LED (the
34
* the pins 4 to 13 on the arduino should directly drive an LED (the
35
35
LED on pin 4 is in the centre of the clock face and the LED on pin
36
36
13 is at the outside.
38
38
* if a longer hand (and a larger clock face) is desired, pin 4 can be
39
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.
40
LEDs that turn on anf off in unison in the centre of the clock.
42
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.
44
* A DS1307 remote clock is connected via I2C on analog pins 4 and 5.
46
46
Implementation details:
50
50
* the timing of the drawing of the clock face is recalculated with
51
51
every rotation of the propeller.
53
* a PC fan actually sends 2 tachometer pulses per revolution, so the
53
* a PC fan actually sends 2 tachiometer pulses per revolution, so the
54
54
software skips every other one. This means that the clock may
55
55
appear upside-down if started with the propeller in the wrong
56
position. You will need to experiment to discover the position that
56
position. You will need to experiment to dicsover the position that
57
57
the propeller must be in when starting the clock.
59
59
Usage instructions:
76
76
******************************************************************************/
78
80
#include "config.h"
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"
82
#include "mode_switcher.h"
90
85
//_____________________________________________________________________________
93
89
// when non-zero, the time (in microseconds) of a new fan pulse that
94
90
// has just occurred, which means that segment drawing needs to be
96
static unsigned long _new_pulse_at = 0;
92
static unsigned long new_pulse_at = 0;
98
94
// the time (in microseconds) when the last fan pulse occurred
99
static unsigned long _last_pulse_at = 0;
95
static unsigned long last_pulse_at = 0;
101
97
// duration (in microseconds) that a segment should be displayed
102
static unsigned long _segment_step = 0;
98
static unsigned long segment_step = 0;
104
100
// 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
101
static unsigned long segment_step_sub_step = 0;
102
static unsigned long segment_step_sub = 0;
104
// flag to indicate that the drawing mode should be cycled to the next one
105
static bool inc_draw_mode = false;
107
// a bounce-managed button
108
static Button button( 3 );
122
110
//_____________________________________________________________________________
126
// activate the current minor mode
127
void activate_minor_mode()
129
switch( _minor_mode ) {
130
case ANALOGUE_CLOCK_IDX: analogue_clock_activate(); break;
131
case DIGITAL_CLOCK_IDX: digital_clock_activate(); break;
140
// activate major mode
141
void activate_major_mode()
143
switch( _major_mode ) {
144
case MAIN_MODE_IDX: activate_minor_mode(); break;
145
case SETTINGS_MODE_IDX: settings_mode_activate(); break;
154
// perform button events
155
void do_button_events()
157
// loop through pending events
158
while( int event = _button.get_event() )
164
switch( _major_mode ) {
166
switch( _minor_mode ) {
167
case ANALOGUE_CLOCK_IDX: analogue_clock_press(); break;
168
case DIGITAL_CLOCK_IDX: digital_clock_press(); break;
171
case SETTINGS_MODE_IDX: settings_mode_press(); break;
177
switch( _major_mode ) {
179
if( ++_minor_mode >= 3 )
181
activate_minor_mode();
183
case SETTINGS_MODE_IDX: settings_mode_long_press(); break;
188
// looooong press (change major mode)
189
if( ++_major_mode > 1 )
191
activate_major_mode();
114
// check for button presses
118
int event = button.update();
123
inc_draw_mode = true;
129
// turn an led on/off
130
void ledOn( int num, bool on )
132
if( num < 0 || num > 9 ) return;
134
// convert to pin no.
137
// pin 4 needs to be inverted (it's driving a PNP)
138
if( num == 4 ) on = !on;
140
digitalWrite( num, on? HIGH : LOW );
198
144
// draw a display segment
199
void draw_next_segment( bool reset )
145
void drawNextSegment( bool reset )
147
static ModeSwitcher mode_switcher;
148
static bool init = false;
152
mode_switcher.activate();
201
155
// keep track of segment
202
156
#if CLOCK_FORWARD
203
157
static int segment = ( NUM_SEGMENTS - CLOCK_SHIFT ) % NUM_SEGMENTS;
207
161
if( reset ) segment = NUM_SEGMENTS - 1 - CLOCK_SHIFT;
210
// reset the text renderer
211
TextRenderer::reset_buffer();
215
switch( _major_mode ) {
217
switch( _minor_mode ) {
218
case ANALOGUE_CLOCK_IDX: analogue_clock_draw_reset(); break;
219
case DIGITAL_CLOCK_IDX: digital_clock_draw_reset(); break;
222
case SETTINGS_MODE_IDX: settings_mode_draw_reset(); break;
225
// tell the text services we're starting a new frame
230
switch( _major_mode ) {
232
switch( _minor_mode ) {
233
case ANALOGUE_CLOCK_IDX: analogue_clock_draw( segment ); break;
234
case DIGITAL_CLOCK_IDX: digital_clock_draw( segment ); break;
235
case TEST_PATTERN_IDX: test_pattern_draw( segment ); break;
238
case SETTINGS_MODE_IDX: settings_mode_draw( segment ); break;
241
// draw any text that was rendered
242
TextRenderer::output_buffer();
165
Drawer &drawer = mode_switcher.get_drawer();
166
if( reset ) drawer.draw_reset();
167
drawer.draw( segment );
244
169
#if CLOCK_FORWARD
245
170
if( ++segment >= NUM_SEGMENTS ) segment = 0;
252
177
// calculate time constants when a new pulse has occurred
253
void calculate_segment_times()
178
void calculateSegmentTimes()
255
180
// check for overflows, and only recalculate times if there isn't
256
181
// one (if there is, we'll just go with the last pulse's times)
257
if( _new_pulse_at > _last_pulse_at )
182
if( new_pulse_at > last_pulse_at )
259
184
// new segment stepping times
260
unsigned long delta = _new_pulse_at - _last_pulse_at;
261
_segment_step = delta / NUM_SEGMENTS;
262
_segment_step_sub = 0;
263
_segment_step_sub_step = delta % NUM_SEGMENTS;
185
unsigned long delta = new_pulse_at - last_pulse_at;
186
segment_step = delta / NUM_SEGMENTS;
187
segment_step_sub = 0;
188
segment_step_sub_step = delta % NUM_SEGMENTS;
266
191
// now we have dealt with this pulse, save the pulse time and
267
192
// clear new_pulse_at, ready for the next pulse
268
_last_pulse_at = _new_pulse_at;
193
last_pulse_at = new_pulse_at;
273
198
// wait until it is time to draw the next segment or a new pulse has
275
void wait_till_end_of_segment( bool reset )
200
void waitTillNextSegment( bool reset )
277
202
static unsigned long end_time = 0;
281
end_time = _last_pulse_at;
206
end_time = last_pulse_at;
283
208
// work out the time that this segment should be displayed until
284
end_time += _segment_step;
285
_segment_step_sub += _segment_step_sub_step;
286
if( _segment_step_sub >= NUM_SEGMENTS ) {
287
_segment_step_sub -= NUM_SEGMENTS;
209
end_time += segment_step;
210
segment_step_sub += segment_step_sub_step;
211
if( segment_step_sub >= NUM_SEGMENTS ) {
212
segment_step_sub -= NUM_SEGMENTS;
292
while( micros() < end_time && !_new_pulse_at );
217
while( micros() < end_time && !new_pulse_at );
296
221
// ISR to handle the pulses from the fan's tachiometer
297
void fan_pulse_handler()
222
void fanPulseHandler()
299
224
// the fan actually sends two pulses per revolution. These pulses
300
225
// may not be exactly evenly distributed around the rotation, so
341
264
// if there has been a new pulse, we'll be resetting the display
342
bool reset = _new_pulse_at? true : false;
265
bool reset = new_pulse_at? true : false;
347
267
// only do this stuff at the start of a display cycle, to ensure
348
268
// that no state changes mid-display
351
// calculate segment times
352
calculate_segment_times();
354
274
// keep track of time
357
// perform button events
275
Time &time = Time::get_instance();
361
279
// draw this segment
362
draw_next_segment( reset );
280
drawNextSegment( reset );
282
// do we need to recalculate segment times?
284
calculateSegmentTimes();
364
286
// wait till it's time to draw the next segment
365
wait_till_end_of_segment( reset );
287
waitTillNextSegment( reset );