Newer
Older
reed
committed
\subsection{NodeInfo (0x09)}
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
A CATS station may want to communicate information about itself. This may be relatively immutable information, such as the hardware revision of the station. It may also include variable information, such as the station's uptime. The NodeInfo whisker provides a range of variables which the station can choose to populate. The NodeInfo uses a bitmap to select which variables are used. This increases efficiency, as unused variables do not need to be transmitted. \textbf{A valid CATS packet contains a maximum of one NodeInfo whisker.}
\subsubsection{Structure}
\begin{tabular}{|l|l|l|l|}
\hline
\textbf{Byte offset} & \textbf{Length} & \textbf{Value} & \textbf{Description} \\
\hline
0 & 1 & 0x09 & Whisker type \\
\hline
1 & 1 & $N$ & Whisker length in bytes \\
\hline
2 & 3 & & Bitmap \\
\hline
5 & $N - 3$ & & Data \\
\hline
\end{tabular}
\subsubsection{Variables}
Below is a table of variables. Each variable has an index, which indicates which bit in the bitmap to set to use the variable. A conversion function is also given, which shows how to convert the given value to the raw value stored in the whisker. Note that the ``Transceiver Temperature'' should be a measurement of some part of the transceiver itself. It should not be used to report air temperature or other meteorological data. \newline
\noindent
\begin{tabular}{|l|l|l|l|l|l|}
\hline
\textbf{Index} & \textbf{Name} & \textbf{Length} & \textbf{Data Type} & \textbf{Conversion function} & \textbf{Units} \\
\hline
0 & Hardware ID & 2 & u16 & $f(x) = x$ & N/A \\
\hline
1 & Software ID & 1 & u8 & $f(x) = x$ & N/A \\
\hline
2 & Uptime & 4 & u32 & $f(x) = x$ & seconds \\
\hline
3 & Antenna height & 1 & u8 & $f(x) = x$ & meters \\
\hline
4 & Antenna gain & 1 & u8 & $f(x) = 4x$ & dBi \\
\hline
5 & TX power & 1 & u8 & $f(x) = 4x$ & dBm \\
\hline
6 & Voltage & 1 & u8 & $f(x) = 10x$ & volts \\
\hline
7 & Transceiver temperature & 1 & i8 & $f(x) = x$ & \degree C \\
\hline
8 & Battery charge & 1 & u8 & $f(x) = 2.55x$ & percent \\
\hline
9 & Altitude (See below) & 4 & f32 & $f(x)= x$ & meters \\
\hline
10 & Balloon (See below) & 0 & N/A & N/A & N/A \\
\hline
11 & Ambient temperature & 1 & i8 & $f(x) = x$ & \degree C \\
\hline
12 & Ambient relative humidity & 1 & u8 & $f(x) = 2.55x$ & percent \\
\hline
13 & Ambient pressure & 2 & u16 & $f(x) = x$ & decapascal (daPa) \\
\hline
\end{tabular}
\textbf{Altitude}: Although the GPS whisker contains altitude already, it is only 2 bytes long. For most applications this is sufficient, but some require additional precision. For example, high altitude balloons need precise altitude information for accurate landing predictions. The NodeInfo whisker provides the ability to use a 4 byte float for altitude. If set, the NodeInfo whisker altitude should take precedence over the GPS whisker altitude. However, the GPS altitude should be set as close as possible to the NodeInfo altitude. This allows a system which does not implement the NodeInfo whisker to still have correct altitude information.
\textbf{Balloon}: If set, this packet was emitted by a high altitude balloon. Please only set this bit on an actual balloon payload. Transmitters incorrectly marked as balloons cause additional work, and complications, for downstream users of CATS. If, for some reason, you want a non-balloon to show up as a balloon, instead set the icon to be a balloon in the identification whisker, and leave the balloon bit clear.
\subsubsection{Bitmap}
The NodeInfo whisker contains a 3-byte, or 24-bit, bitmap to keep track of which variables are actually used. The extra bits are intended to allow additional variables in the future. The MSB is assigned the index 23; the LSB is index 0. This corresponds to the variables in the above table.
\subsubsection{Example}
\begin{tabular}{|l|l|}
\hline
\textbf{Variables} & \textbf{Whisker Data (Hex)} \\
\hline
\makecell{
Hardware ID: 7408 \\
Uptime: 98 seconds \\
TX Power: 30 dBm \\
Voltage: 12.8 V} & 09 0B 00 00 65 F0 1C 62 00 00 00 78 80 \\
\hline
\end{tabular}