]> git.zerfleddert.de Git - fnordlicht-mini/blame_incremental - firmware/fnordlicht-firmware/storage.h
reference firmware
[fnordlicht-mini] / firmware / fnordlicht-firmware / storage.h
... / ...
CommitLineData
1/* vim:ts=4 sts=4 et tw=80
2 *
3 * fnordlicht firmware
4 *
5 * for additional information please
6 * see http://lochraster.org/fnordlichtmini
7 *
8 * (c) by Alexander Neumann <alexander@bumpern.de>
9 *
10 * This program is free software: you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License version 3 as published by
12 * the Free Software Foundation.
13 *
14 * This program is distributed in the hope that it will be useful, but WITHOUT
15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
16 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
17 * more details.
18 *
19 * You should have received a copy of the GNU General Public License along with
20 * this program. If not, see <http://www.gnu.org/licenses/>.
21 */
22
23#ifndef __STORAGE_H
24#define __STORAGE_H
25
26#include "color.h"
27#include "remote-proto.h"
28#include <avr/eeprom.h>
29#include <stdint.h>
30#include <stdbool.h>
31
32/* store a color configuration in EEPROM
33 * size: 8 byte
34 *
35 * use union color_t here, check rgb_marker! */
36struct storage_color_t
37{
38 uint8_t step;
39 uint8_t delay;
40 uint16_t pause;
41 union color_t color;
42};
43
44#define EEPROM_MAGIC_BYTE 0x23
45
46/* store the startup configuration in EEPROM
47 * size: 13 byte */
48struct storage_config_t
49{
50 /* magic byte, must match EEPROM_MAGIC_BYTE to mark a valid configuration */
51 uint8_t magic;
52 /* startup parameters, defined in remote_proto.h, size: 12 byte */
53 struct startup_parameters_t params;
54};
55
56/* storage structure for EEPROM
57 * size: 494 byte
58 * (means: 18 byte left) */
59struct storage_t
60{
61 /* startup configuration, size: 12 byte */
62 struct storage_config_t config;
63
64 /* color storage, size: 60*8 == 480 byte */
65 struct storage_color_t color[CONFIG_EEPROM_COLORS];
66
67 /* crc16 checksum over config and color[], size: 2 byte */
68 uint16_t checksum;
69};
70
71/* global structures */
72extern struct storage_config_t startup_config;
73extern EEMEM struct storage_t eeprom_storage;
74
75/* initialize storage */
76void storage_init(void);
77/* poll storage */
78void storage_poll(void);
79
80/* save storage config cfg to eeprom */
81void storage_save_config(void);
82/* load storage config cfg from eeprom */
83void storage_load_config(void);
84
85void storage_save_color(uint8_t position, struct storage_color_t *color);
86void storage_load_color(uint8_t position, struct storage_color_t *color);
87
88/* return true if configuration has been loaded and is valid */
89bool storage_valid_config(void);
90
91#endif
Impressum, Datenschutz