doc: Split out EasyMini into a separate manual
[fw/altos] / doc / flight-data-recording.inc
1 [appendix]
2 == Flight Data Recording
3       
4         Each flight computer logs data at 100 samples per second
5         during ascent and 10 samples per second during
6         ifdef::telemini[]
7         descent, except for TeleMini v1.0, which records ascent at 10 samples
8         per second and descent at 1 sample per second.
9         endif::telemini[]
10         ifndef::telemini[]
11         descent.
12         endif::telemini[]
13         Data are logged to
14         an on-board flash memory part, which can be partitioned into
15         several equal-sized blocks, one for each flight.
16
17         .Data Storage on Altus Metrum altimeters
18         [options="header",cols="1,1,1,1"]
19         |====
20         |Device                 |Bytes per Sample       |Total Storage  |Minutes at Full Rate
21         ifdef::telemetrum[]
22         |TeleMetrum v1.0        |8      |1MB    |20
23         |TeleMetrum v1.1 v1.2   |8      |2MB    |40
24         |TeleMetrum v2.0        |16     |8MB    |80
25         endif::telemetrum[]
26         ifdef::telemini[]
27         |TeleMini v1.0          |2      |5kB    |4
28         |TeleMini v2.0          |16     |1MB    |10
29         endif::telemini[]
30         ifdef::easymini[]
31         |EasyMini               |16     |1MB    |10
32         endif::easymini[]
33         ifdef::telemega[]
34         |TeleMega               |32     |8MB    |40
35         endif::telemega[]
36         ifdef::easymega[]
37         |EasyMega               |32     |8MB    |40
38         endif::easymega[]
39         |====
40       
41         The on-board flash is partitioned into separate flight logs,
42         each of a fixed maximum size. Increase the maximum size of
43         each log and you reduce the number of flights that can be
44         stored. Decrease the size and you can store more flights.
45             
46         Configuration data is also stored in the flash memory on
47         ifdef::telemetrum[TeleMetrum v1.x,]
48         ifdef::telemini[TeleMini and]
49         ifdef::easymini[EasyMini.]
50         This consumes 64kB
51         of flash space.  This configuration space is not available
52         for storing flight log data.
53
54         ifdef::telemetrum,telemega,easymega[]
55         TeleMetrum v2.0, TeleMega and EasyMega
56         store configuration data in a bit of eeprom available within
57         the processor chip, leaving that space available in flash for
58         more flight data.
59         endif::telemetrum,telemega,easymega[]
60             
61         To compute the amount of space needed for a single flight, you
62         can multiply the expected ascent time (in seconds) by 100
63         times bytes-per-sample, multiply the expected descent time (in
64         seconds) by 10 times the bytes per sample and add the two
65         together. That will slightly under-estimate the storage (in
66         bytes) needed for the flight.
67         ifdef::telemetrum[]
68         For instance, a TeleMetrum v2.0 flight spending
69         20 seconds in ascent and 150 seconds in descent will take
70         about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You
71         could store dozens of these flights in the on-board flash.
72         endif::telemetrum[]
73             
74         The default size allows for several flights on each flight
75         ifdef::telemini[]
76         computer, except for TeleMini v1.0, which
77         only holds data for a single flight.
78         endif::telemini[]
79         ifndef::telemini[]
80         computer.
81         endif::telemini[]
82         You can adjust the size.
83             
84         Altus Metrum flight computers will not overwrite existing
85         flight data, so be sure to download flight data and erase it
86         from the flight computer before it fills up. The flight
87         computer will still successfully control the flight even if it
88         cannot log data, so the only thing you will lose is the data.