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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
/*
* Copyright (C) 2016 by Daniel Friesel
*
* License: You may use, redistribute and/or modify this file under the terms
* of either:
* * The GNU LGPL v3 (see COPYING and COPYING.LESSER), or
* * The 3-clause BSD License (see COPYING.BSD)
*
*/
#include <stdlib.h>
#define SHUTDOWN_THRESHOLD 2048
/**
* Contains the system idle loop. Checks for button presses, handles
* standby/resume, reads data from the Modem and updates the Display.
*/
class System {
private:
/**
* Shutdown threshold counter. Contains the time since both
* buttons were first pressed at the same time in 256µs steps.
*/
uint16_t want_shutdown;
/**
* Debounce counter for button presses. Buttons are ignored while
* this value is greater than zero
*/
uint8_t btn_debounce;
/**
* Index of the currently active animation
*/
uint8_t current_anim_no;
/**
* Shuts down the entire system. Shows a shutdown animation, waits
* untel both buttons are released, turns off all hardware and puts
* the system to sleep. Re-enables the hardware and shows the
* last active animation after a wakeup
*/
void shutdown(void);
/**
* Modem receive function. Maintains the internal state machine
* (see RxExpect)
*/
void receive(void);
/**
* Loads a pattern from the EEPROM and shows it on the display.
* Loads the first 132 bytes (4 bytes header + 128 bytes data) of
* the pattern into the global disp_buf variable, updates the
* global active_anim to reflect the read metadata and calls
* Display::show() to display the pattern.
*
* @param pattern_no index of pattern to show
*/
void loadPattern(uint8_t pattern_no);
/**
* Show the pattern stored in pattern on the display.
* Updates the global active_anim object with the metadata
* stored in the first four bytes of pattern and cals
* Display::show() to display it
*
* @param pattern array containing the pattern
*/
void loadPattern_buf(uint8_t *pattern);
/**
* Load pattern from PROGMEM. Loads the entire pattern stored
* at pattern_ptr into the global disp_buf variable, updates
* the global active_anim object with the metadata stored in the
* first four pattern bytes and calls Display::show() to display
* the pattern. The pattern data must not be longer than 128 bytes.
*
* @param pattern_ptr pointer to pattern data in PROGMEM
*/
void loadPattern_P(const uint8_t *pattern_ptr);
enum TransmissionControl : uint8_t {
BYTE_END = 0x84,
BYTE_START = 0x99,
BYTE_PATTERN = 0xa9,
};
enum ButtonMask : uint8_t {
BUTTON_NONE = 0,
BUTTON_LEFT = 1,
BUTTON_RIGHT = 2,
BUTTON_BOTH = 3
};
enum RxExpect : uint8_t {
START1,
START2,
NEXT_BLOCK,
PATTERN1,
PATTERN2,
HEADER1,
HEADER2,
META1,
META2,
DATA_FIRSTBLOCK,
DATA,
};
RxExpect rxExpect;
ButtonMask btnMask;
public:
System() { want_shutdown = 0; rxExpect = START1; current_anim_no = 0; btnMask = BUTTON_NONE; btn_debounce = 0;};
/**
* Initial MCU setup. Turns off unused peripherals to save power
* and configures the button pins. Also configures all other pins
* and peripherals using the enable function of their respective
* classes. Turns on interrupts once that's done.
*/
void initialize(void);
/**
* System idle loop. Checks for button presses, handles
* standby/resume, reads data from the Modem and updates the Display.
*
* It is recommended to run this function before going back to sleep
* whenever the system is woken up by an interrupt.
*/
void loop(void);
/**
* Resets the modem receive state machine and loads the
* "Transmission error" message. Called by the Watchdog Timeout
* ISR when a transmission was started (2x START received) but not
* properly finished (that is, four seconds passed since the last
* received byte and END byte was receveid).
*/
void handleTimeout(void);
};
extern System rocket;
|
