altos/test: Adjust CRC error rate after FEC fix
[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         |TeleMetrum v3.0        |16     |8MB    |80
26         endif::telemetrum[]
27         ifdef::telemini[]
28         |TeleMini v1.0          |2      |5kB    |4
29         |TeleMini v3.0          |16     |512kB  |5
30         endif::telemini[]
31         ifdef::easymini[]
32         |EasyMini               |16     |1MB    |10
33         endif::easymini[]
34         ifdef::telemega[]
35         |TeleMega               |32     |8MB    |40
36         endif::telemega[]
37         ifdef::easymega[]
38         |EasyMega               |32     |8MB    |40
39         endif::easymega[]
40         |====
41       
42         The on-board flash is partitioned into separate flight logs,
43         each of a fixed maximum size. Increase the maximum size of
44         each log and you reduce the number of flights that can be
45         stored. Decrease the size and you can store more flights.
46             
47         Configuration data is also stored in the flash memory on
48         ifdef::telemetrum[TeleMetrum v1.x,]
49         ifdef::telemini[TeleMini v3.0 and]
50         ifdef::easymini[EasyMini.]
51         This consumes 64kB
52         of flash space.  This configuration space is not available
53         for storing flight log data.
54
55         ifdef::telemetrum,telemega,easymega[]
56         TeleMetrum v2 or newer, TeleMega and EasyMega
57         store configuration data in a bit of eeprom available within
58         the processor chip, leaving that space available in flash for
59         more flight data.
60         endif::telemetrum,telemega,easymega[]
61             
62         To compute the amount of space needed for a single flight, you
63         can multiply the expected ascent time (in seconds) by 100
64         times bytes-per-sample, multiply the expected descent time (in
65         seconds) by 10 times the bytes per sample and add the two
66         together. That will slightly under-estimate the storage (in
67         bytes) needed for the flight.
68         ifdef::telemetrum[]
69         For instance, a TeleMetrum v2 or newer flight spending
70         20 seconds in ascent and 150 seconds in descent will take
71         about (20 * 1600) + (150 * 160) = 56000 bytes of storage. You
72         could store dozens of these flights in the on-board flash.
73         endif::telemetrum[]
74             
75         The default size allows for several flights on each flight
76         ifdef::telemini[]
77         computer, except for TeleMini v1.0, which
78         only holds data for a single flight.
79         endif::telemini[]
80         ifndef::telemini[]
81         computer.
82         endif::telemini[]
83         You can adjust the size.
84             
85         Altus Metrum flight computers will not overwrite existing
86         flight data, so be sure to download flight data and erase it
87         from the flight computer before it fills up. The flight
88         computer will still successfully control the flight even if it
89         cannot log data, so the only thing you will lose is the data.