update docs
[web/altusmetrum] / AltOS / doc / telelaunch.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <meta http-equiv="X-UA-Compatible" content="IE=edge">
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 2.0.16">
8 <meta name="author" content="Bdale Garbee">
9 <meta name="copyright" content="Bdale Garbee 2021">
10 <title>TeleLaunch: The Altus Metrum Wireless Launch Control System</title>
11 <link rel="stylesheet" href="./am.css">
12 </head>
13 <body class="book">
14 <div id="header">
15 <h1>TeleLaunch: The Altus Metrum Wireless Launch Control System</h1>
16 <div class="details">
17 <span id="author" class="author">Bdale Garbee</span><br>
18 <span id="email" class="email"><a href="mailto:bdale@gag.com">bdale@gag.com</a></span><br>
19 <span id="revnumber">version v1.9.9,</span>
20 <span id="revdate">06 Oct 2021</span>
21 </div>
22 <div id="toc" class="toc">
23 <div id="toctitle">Table of Contents</div>
24 <ul class="sectlevel1">
25 <li><a href="#_license">License</a></li>
26 <li><a href="#_acknowledgments">Acknowledgments</a></li>
27 <li><a href="#_introduction_and_overview">1. Introduction and Overview</a></li>
28 <li><a href="#_configuration">2. Configuration</a>
29 <ul class="sectlevel2">
30 <li><a href="#_connecting_to_a_unit">2.1. Connecting to a Unit</a></li>
31 <li><a href="#_telelco">2.2. TeleLCO</a></li>
32 <li><a href="#_telefireeight">2.3. TeleFireEight</a></li>
33 <li><a href="#_operating_frequency">2.4. Operating Frequency</a></li>
34 <li><a href="#_callsign">2.5. Callsign</a></li>
35 <li><a href="#_aes_key">2.6. AES Key</a></li>
36 <li><a href="#_bank_number">2.7. Bank Number</a></li>
37 </ul>
38 </li>
39 <li><a href="#_operation">3. Operation</a>
40 <ul class="sectlevel2">
41 <li><a href="#_charging_batteries">3.1. Charging Batteries</a></li>
42 <li><a href="#_setting_up">3.2. Setting Up</a></li>
43 <li><a href="#_turning_system_on">3.3. Turning System On</a></li>
44 <li><a href="#_launch_one_rocket">3.4. Launch One Rocket</a></li>
45 <li><a href="#_launch_a_multi_rocket_drag_race">3.5. Launch A Multi-Rocket "Drag Race"</a></li>
46 </ul>
47 </li>
48 <li><a href="#_specifications">4. Specifications</a></li>
49 <li><a href="#_updating_firmware">5. Updating Firmware</a></li>
50 <li><a href="#_making_pad_cables">Appendix A: Making Pad Cables</a></li>
51 <li><a href="#_troubleshooting">Appendix B: Troubleshooting</a>
52 <ul class="sectlevel2">
53 <li><a href="#_telefire_fails_to_arm">B.1. TeleFire Fails to Arm</a></li>
54 <li><a href="#_radio_signal_strength">B.2. Radio Signal Strength</a></li>
55 </ul>
56 </li>
57 </ul>
58 </div>
59 </div>
60 <div id="content">
61 <div id="preamble">
62 <div class="sectionbody">
63 <div id="logo" class="imageblock">
64 <div class="content">
65 <a class="image" href="https://altusmetrum.org"><img src="altusmetrum-oneline.svg" alt="Altus Metrum"></a>
66 </div>
67 </div>
68 </div>
69 </div>
70 <div class="sect1">
71 <h2 id="_license">License</h2>
72 <div class="sectionbody">
73 <div class="paragraph">
74 <p>Copyright © 2021 Bdale Garbee and Keith Packard</p>
75 </div>
76 <div class="paragraph">
77 <p>This document is released under the terms of the <a href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons ShareAlike 3.0 License</a></p>
78 </div>
79 </div>
80 </div>
81 <div class="sect1">
82 <h2 id="_acknowledgments">Acknowledgments</h2>
83 <div class="sectionbody">
84 <div class="paragraph">
85 <p>Our profound thanks to Terry Lee for major contributions to making
86 the TeleLaunch system something we could actually package and sell!</p>
87 </div>
88 <div class="paragraph">
89 <p>Tripoli Colorado, Oregon Rocketry, New River Valley Rocketry, and
90 the National Association of Rocketry helped instigate this work,
91 and/or were early adopters of TeleLaunch.  We learned a lot working
92 with each organization.  Thank you!</p>
93 </div>
94 <div class="paragraph">
95 <p>Thanks also to our friends in the Kloudbusters, both for helping
96 us understand what it takes to run truly great large-scale launches,
97 and for providing some completely deserved, scathing feedback on
98 an early prototype of TeleLCO.</p>
99 </div>
100 <div class="paragraph">
101 <p>Have fun using these products, and we hope to meet all of you
102 out on a rocket flight line somewhere.</p>
103 </div>
104 <div class="verseblock">
105 <pre class="content">Bdale Garbee, KB0G
106 NAR #87103, TRA #12201</pre>
107 </div>
108 <div class="verseblock">
109 <pre class="content">Keith Packard, KD7SQG
110 NAR #88757, TRA #12200</pre>
111 </div>
112 </div>
113 </div>
114 <div class="sect1">
115 <h2 id="_introduction_and_overview">1. Introduction and Overview</h2>
116 <div class="sectionbody">
117 <div class="paragraph">
118 <p>Welcome to the Altus Metrum community!  Our circuits and software reflect
119 our passion for both hobby rocketry and Free Software.  We hope their
120 capabilities and performance will delight you in every way, but by
121 releasing all of our hardware and software designs under open licenses,
122 we also hope to empower you to take as active a role in our collective
123 future as you wish!</p>
124 </div>
125 <div class="paragraph">
126 <p>Thank you for your interest in TeleLaunch, a wireless control system for
127 launching hobby rockets.  Each TeleLaunch system contains at least two units,
128 a launch control box (TeleLCO) and one or more launch initiation boxes
129 (TeleFire).  In this manual, we hope to provide all the information required
130 to configure and successfully operate a TeleLaunch system.</p>
131 </div>
132 <div class="paragraph">
133 <p>Unlike other Altus Metrum products, that are usually provided as circuit
134 boards that the user must arrange to mount and wire up, all products in the
135 TeleLaunch system are sold as fully packaged, almost-ready-to-use units.  This
136 means that with only minimal one-time configuration of each unit, a TeleLaunch
137 system can be made ready for use very quickly.</p>
138 </div>
139 <div class="paragraph">
140 <p>Because documentation is just as prone as software to contain "bugs", and
141 can always be improved&#8230;&#8203;  If you have questions that aren&#8217;t answered in this
142 manual, or just need a little help figuring things out, we strongly suggest
143 joining the Altus Metrum user email list, which you can do by visiting
144 <a href="https://lists.gag.com/mailman/listinfo/altusmetrum" class="bare">https://lists.gag.com/mailman/listinfo/altusmetrum</a>.</p>
145 </div>
146 </div>
147 </div>
148 <div class="sect1">
149 <h2 id="_configuration">2. Configuration</h2>
150 <div class="sectionbody">
151 <div class="paragraph">
152 <p>There are three things you need to configure identically in each unit
153 that is part of a TeleLaunch system for wireless communications to
154 succeed.  Those are the operating frequency, the callsign, and a key
155 for the AES encryption algorithm.  Additionally, each TeleFire unit
156 also needs to be configured with a unique bank number.</p>
157 </div>
158 <div class="paragraph">
159 <p>Please note that these values must match exactly, or the system will
160 not operate as expected.  That means the callsign needs to have the
161 same choices of upper or lower case, no trailing spaces, etc.  And
162 the operating frequency and AES key must match.</p>
163 </div>
164 <div class="sect2">
165 <h3 id="_connecting_to_a_unit">2.1. Connecting to a Unit</h3>
166 <div class="paragraph">
167 <p>Configuring each unit of a TeleLaunch system requires use of
168 a micro USB cable, and a computer with a suitable terminal
169 emulation program.  Connect a suitable cable, open your
170 favoriate terminal emulation program, and power up the unit.
171 By pressing &lt;enter&gt; you should see a command prompt.</p>
172 </div>
173 </div>
174 <div class="sect2">
175 <h3 id="_telelco">2.2. TeleLCO</h3>
176 <div class="paragraph">
177 <p>The USB connector on TeleLCO is accessible without
178 opening the lid of the Pelican box.  Look for the
179 blue dust cap over the connector under the handle.</p>
180 </div>
181 </div>
182 <div class="sect2">
183 <h3 id="_telefireeight">2.3. TeleFireEight</h3>
184 <div class="paragraph">
185 <p>The USB connector on TeleFireEight is located on the
186 circuit board.  To access it, open the box and flip
187 the lid up.  you should be able to spot a vertical
188 micro USB connector on the board near the DIP switch.</p>
189 </div>
190 <div class="admonitionblock warning">
191 <table>
192 <tr>
193 <td class="icon">
194 <img src="./images/icons/warning.svg" alt="Warning">
195 </td>
196 <td class="content">
197 Please take care when closing the TeleFireEight lid
198 not to pinch any wires.
199 </td>
200 </tr>
201 </table>
202 </div>
203 </div>
204 <div class="sect2">
205 <h3 id="_operating_frequency">2.4. Operating Frequency</h3>
206 <div class="paragraph">
207 <p>The TeleLaunch system supports operation over much of the
208 "70cm" Amateur Radio band, with the filters optimized for a
209 center frequency of 435 MHz.  For each system, a single
210 operating frequency should be selected and programmed into
211 each unit.</p>
212 </div>
213 <div class="paragraph">
214 <p>The default frequency for units leaving the factory is
215 435.750 MHz.  Since Altus Metrum flight computers operate
216 by default on 10 100khz channels from 434.550 to 435.450 MHz,
217 we chose this frequency to be far enough away from flight
218 computers to avoid any interference, but still close enough
219 to the radio subsystem design center frequency for great
220 performance.</p>
221 </div>
222 <div class="paragraph">
223 <p>To configure the frequency, use your terminal emulator to
224 issue two commands.  First, use 'c F xxxxxx' where the xxxxxx
225 is replaced with the desired operating frequency in kHz.  Then
226 use the 'c w' command to save this value into non-volatile
227 memory.  For example, the default 435.750 MHz would be
228 configured using</p>
229 </div>
230 <div class="paragraph">
231 <p>c F 435750<br>
232 c w</p>
233 </div>
234 <div class="paragraph">
235 <p>Note that the 'f' parameter is a frequency calibration value
236 that you really, really, really don&#8217;t want to change.  So,
237 please be careful to make sure you use capital 'F', not lower
238 case 'f' when changing the operating frequency!</p>
239 </div>
240 </div>
241 <div class="sect2">
242 <h3 id="_callsign">2.5. Callsign</h3>
243 <div class="paragraph">
244 <p>In the US, you need an
245 <a href="http://www.altusmetrum.org/Radio/">amateur radio license</a>
246 or other authorization to legally operate the radio
247 transmitters that are part of TeleLaunch.</p>
248 </div>
249 <div class="paragraph">
250 <p>The default callsign shipped from the factory is "N0CALL",
251 which is not a valid callsign and meant to humorously point
252 out that the callsign hasn&#8217;t been configured yet.</p>
253 </div>
254 <div class="paragraph">
255 <p>Individual owners of a TeleLaunch system should use their
256 own callsign.</p>
257 </div>
258 <div class="paragraph">
259 <p>Club owners of a TeleLaunch system should pick the callsign
260 of one club member who is willing to be designated as the
261 control operator of the system.  Under FCC Part 97 rules,
262 being the control operator does not mean you have to be LCO
263 all the time, it just means taking responsibility for ensuring
264 the system is being operated in compliance with the rules.</p>
265 </div>
266 <div class="paragraph">
267 <p>To configure the callsign, use your terminal emulator to
268 issue two commands.  First, use 'c c callsign' to set the
269 callsign, then use 'c w' to write to non-volatile memory.
270 For example, to set the default N0CALL, the commands would
271 be</p>
272 </div>
273 <div class="paragraph">
274 <p>c c N0CALL<br>
275 c w</p>
276 </div>
277 </div>
278 <div class="sect2">
279 <h3 id="_aes_key">2.6. AES Key</h3>
280 <div class="paragraph">
281 <p>For safety, TeleLaunch uses cryptographic checksums to help
282 prevent interference, intentional or un-intentional.  This
283 means each system must have a shared AES encryption key
284 identically configured into each unit.</p>
285 </div>
286 <div class="paragraph">
287 <p>The key size required is 128 bits, which must be expressed
288 as a 32-digit hexadecimal number.</p>
289 </div>
290 <div class="paragraph">
291 <p>To configure the AES key, use 'c a key' followed by 'c w'
292 to write the key to non-volatile memory.  For example, to
293 configure your system with a key that is the answer to life,
294 the universe, and everything, the commands would be</p>
295 </div>
296 <div class="paragraph">
297 <p>c a 00000000000000000000000000000042<br>
298 c w</p>
299 </div>
300 </div>
301 <div class="sect2">
302 <h3 id="_bank_number">2.7. Bank Number</h3>
303 <div class="paragraph">
304 <p>Each TeleFire unit needs to be configured with a bank number,
305 and bank numbers should be unique within a given system.  For
306 most systems with 8 or fewer banks, just use the DIP switch
307 on the circuit board inside the TeleFire unit to select the
308 desired bank.  Only one switch should be turned on.  Switch
309 one means bank one, etc.</p>
310 </div>
311 <div class="paragraph">
312 <p>To allow systems to have more than 8 banks, if all the DIP
313 switches are "off", the unit will use the bank configured in
314 non-volatile memory.</p>
315 </div>
316 <div class="paragraph">
317 <p>To configure the bank number, use 'c B bank' followed by
318 'c w' to write to non-volatile memory.  For example, to
319 set the bank to 42, the commands would be:</p>
320 </div>
321 <div class="paragraph">
322 <p>c B 42<br>
323 c w</p>
324 </div>
325 </div>
326 </div>
327 </div>
328 <div class="sect1">
329 <h2 id="_operation">3. Operation</h2>
330 <div class="sectionbody">
331 <div class="paragraph">
332 <p>Operating a TeleLaunch system is pretty easy, and we hope fairly
333 intuitive for anyone who has ever launched rockets before.  Basic
334 instructions are printed on a decal inside the lid of each TeleLCO
335 unit, which early customers (before this manual was even written)
336 reported were sufficient to successfully use the system.</p>
337 </div>
338 <div class="paragraph">
339 <p>The remainder of this section assumes the system has already been
340 properly configured with callsign, AES key, and bank numbers for each
341 TeleFire box.</p>
342 </div>
343 <div class="sect2">
344 <h3 id="_charging_batteries">3.1. Charging Batteries</h3>
345 <div class="paragraph">
346 <p>TeleLCO has an internal Lithium Polymer battery that is
347 charged over USB.  A weather-tight micro USB connector is
348 installed with a blue cap under the handle.  This position
349 was chosen so that TeleLCO can be charged while the lid is
350 closed and standing handle-up.  Attach a micro USB cable
351 to a computer or other source of USB power.  There are two
352 charge indicators on the panel that will illuminate during
353 charging, red for charge in progress and green for charge
354 complete.</p>
355 </div>
356 <div class="paragraph">
357 <p>TeleFire has an internal sealed lead acid 12V battery, and
358 is provided with an external AC charger.  Connect this charger
359 to the PowerPole connector on the back face of the box to
360 charge the battery.  Other sources of charging current for
361 a nominal 12V sealed battery may be used.  The charge
362 connector can also be used to attach an external battery if
363 needed.</p>
364 </div>
365 </div>
366 <div class="sect2">
367 <h3 id="_setting_up">3.2. Setting Up</h3>
368 <div class="paragraph">
369 <p>Each unit in the TeleLaunch system needs a suitable antenna
370 attached.  A typical configuration would involve the provided
371 omni-directional antenna or optional directional antenna aimed
372 at the field mounted on a pole attached to TeleLCO at the
373 launch control station, and the provided rubber whip antennas
374 on each TeleFire box.</p>
375 </div>
376 <div class="paragraph">
377 <p>If deploying the system in rough terrain, on a field with
378 dense vegetation, or at great distances (some away cells), you
379 may need a better antenna or at least to mount the antenna
380 higher off the ground.  All units in the TeleLaunch system
381 have tri-color RF signal strength indicators.  A system should
382 show green on all units during normal operation.  An occasional
383 dip to amber is ok, but frequent amber or any red indicates a
384 need to improve the antenna situation.</p>
385 </div>
386 <div class="paragraph">
387 <p>Antenna made for use near 435 Mhz in the ham radio "70cm band"
388 should work, and there are many online sources of information
389 on making inexpensive, highly effective antennas at home.</p>
390 </div>
391 <div class="paragraph">
392 <p>The TeleLCO unit should be placed on a table at the Launch
393 Control position.  It can be helpful for the LCO (the human(s)
394 too, not just the electronics!) to be provided with some
395 shade, but the use of reflective LCDs for the digit
396 displays and ultri-bright LEDs make TeleLCO operation
397 reasonable even in direct sunlight.</p>
398 </div>
399 <div class="paragraph">
400 <p>Each TeleFire box should be placed in proximity to the launch
401 rails it will service.  Whip clips made from AC power cords
402 (not provided) should be attached to TeleFire and routed to
403 each launch rail.  The pyro output on each channel is
404 connected to the "line" and "neutral" pins on the outlet,
405 while the ground pin is attached to chassis ground.</p>
406 </div>
407 </div>
408 <div class="sect2">
409 <h3 id="_turning_system_on">3.3. Turning System On</h3>
410 <div class="paragraph">
411 <p>Turn on all TeleFire pad boxes in the system.  At power-on,
412 all LEDs will turn on briefly so you can verify they&#8217;re all
413 working.  The radio signal strength indicators will show red
414 until TeleLCO is turned on.</p>
415 </div>
416 <div class="paragraph">
417 <p>Turn on TeleLCO.  All LCD segments and LEDs will turn on
418 briefly so you can verify they&#8217;re all working.  An exception
419 are the two battery charger LEDs, which only illuminate when
420 the battery is charging.  The LCD displays will then briefly
421 display the internal battery voltage, which should be at least
422 3.9V for normal operation.  TeleLCO then scans to locate all
423 TeleFire boxes that are in range and configured for the same
424 frequency, callsign, and AES key.  During this process, the
425 Bank LCD diplays will appear to be counting up from 1 to 99.
426 When the search is complete, the Pad display will show the
427 number of TeleFire devices found.  TeleLCO beeps when ready.</p>
428 </div>
429 </div>
430 <div class="sect2">
431 <h3 id="_launch_one_rocket">3.4. Launch One Rocket</h3>
432 <div class="paragraph">
433 <p>Switch the TeleFire to 'Safe' and confirm it is silent.</p>
434 </div>
435 <div class="paragraph">
436 <p>Put a rocket on a launch rail / rod, and connect whip clips
437 from a pad output on a TeleFire unit to the motor igniter.
438 Verify igniter continuity using the LED associated with that
439 output.  Green is good.</p>
440 </div>
441 <div class="paragraph">
442 <p>Switch the TeleFire unit from 'Safe' to 'Arm', at which point
443 it will start "chirping" to indicate that it is "armed and
444 dangerous".  Move to the TeleLCO at a safe distance away.</p>
445 </div>
446 <div class="paragraph">
447 <p>Ensure the TeleLCO blue Drag Race switch is on Normal and
448 the blue Drag Race LED is extinguished.</p>
449 </div>
450 <div class="paragraph">
451 <p>Select the desired TeleFire unit by pushing the TeleLCO
452 selector knob until the "Bank" LED is lit, then rotating the
453 knob until the
454 desired box is selected.  Then push the knob until the Pad
455 LED is lit and rotate the knob until the desired pad is
456 selected.  Verify the Remote Armed LED is lit, and that the
457 selected pad&#8217;s Igniter Continuity LED is lit.</p>
458 </div>
459 <div class="paragraph">
460 <p>Perform range safety checks.</p>
461 </div>
462 <div class="paragraph">
463 <p>Move the TeleLCO SAFE/ARM switch to ARM.  This will cause
464 the selected TeleFire unit&#8217;s strobe to start flashing and
465 siren to become more insistent.</p>
466 </div>
467 <div class="paragraph">
468 <p>Perform count-down.</p>
469 </div>
470 <div class="paragraph">
471 <p>Depress the LAUNCH button and hold until the rocket launches.</p>
472 </div>
473 <div class="paragraph">
474 <p>Move the TeleLCO SAFE/ARM switch back to SAFE.</p>
475 </div>
476 </div>
477 <div class="sect2">
478 <h3 id="_launch_a_multi_rocket_drag_race">3.5. Launch A Multi-Rocket "Drag Race"</h3>
479 <div class="paragraph">
480 <p>To enable drag race mode, move the TeleLCO blue switch to
481 Drag Race.  The blue Drag Race LED should illuminate.</p>
482 </div>
483 <div class="paragraph">
484 <p>Select pads to include in the drag race by using the same
485 process as for a single rocket to select each Bank and Pad,
486 then press Add/Remove to toggle the currently selected pad
487 in the race.  The continuity LEDs blink ON/off for selected,
488 and on/OFF for deselected (long ON means in the race).</p>
489 </div>
490 <div class="paragraph">
491 <p>A drag race can be configured to include pads on multiple
492 TeleFire boxes, but the blinking continuity indicators to
493 show which pads are included can only indicate the currently
494 selected bank.</p>
495 </div>
496 <div class="paragraph">
497 <p>Verify remotes are ready and armed by using the Remote Armed
498 and Igniter Continuity LEDs.</p>
499 </div>
500 <div class="paragraph">
501 <p>Perform range safety checks.</p>
502 </div>
503 <div class="paragraph">
504 <p>Move the TeleLCO SAFE/ARM switch to ARM.  This will cause
505 the selected TeleFire units strobes to start flashing and
506 sirens to become more insistent.</p>
507 </div>
508 <div class="paragraph">
509 <p>Perform count-down.</p>
510 </div>
511 <div class="paragraph">
512 <p>Depress the LAUNCH button and hold until rockets launch.</p>
513 </div>
514 <div class="paragraph">
515 <p>Move the TeleLCO SAFE/ARM switch back to SAFE.</p>
516 </div>
517 <div class="paragraph">
518 <p>Move Drag Race switch back to Normal.</p>
519 </div>
520 <div class="paragraph">
521 <p>Note that if there is a mis-fire in a drag race and you want
522 to fix igniters and try again, the current drag configuration
523 is preserved as long as you stay in Drag Race mode.  So you
524 can SAFE the system, fix igniters, and try again before leaving
525 Drag Race mode if desired.</p>
526 </div>
527 </div>
528 </div>
529 </div>
530 <div class="sect1">
531 <h2 id="_specifications">4. Specifications</h2>
532 <div class="sectionbody">
533 <div class="paragraph">
534 <p>The TeleLaunch system can handle up to 99 banks with each bank
535 having up to 8 pads, for a total of 792 pads.</p>
536 </div>
537 <div class="paragraph">
538 <p>Each unit in the TeleLaunch system is water-resistant, but is not
539 intended to be directly immersed in water.  Brief rain showers during
540 a launch should pose no problem, but it&#8217;s recommended to cover units
541 or bring them inside when not in use or during extended periods of
542 bad weather.</p>
543 </div>
544 <div class="paragraph">
545 <p>TeleLCO uses an internal single-cell 2Ah Lithium Polymer battery,
546 which is sufficient for multiple days of typical operation.  This
547 battery is charged over USB.</p>
548 </div>
549 <div class="paragraph">
550 <p>TeleFire uses an internal sealed lead-acid 12V battery, which is
551 charged by an external charger attached through the PowerPole
552 connector on the rear panel.</p>
553 </div>
554 <div class="paragraph">
555 <p>Pyro initiation uses the 12V sealed lead-acid battery.  Current
556 to any pad can exceed 30A, and with typical igniters every pad on
557 a TeleFire can be successfully included in a drag race.  The system
558 controls current flow to prevent damage, and has a self-resetting
559 circuit breaker for ultimate protection should something go badly
560 wrong.</p>
561 </div>
562 <div class="paragraph">
563 <p>TeleLaunch uses AES encryption with a shared key between each unit
564 in the system to ensure the integrity of safe launch operations.</p>
565 </div>
566 <div class="paragraph">
567 <p>The TeleLaunch system uses radio frequency communications in the
568 vicinity of 435 Mhz.  A US amateur radio license or equivalent
569 authorization is required to legally use the system.  The operating
570 frequency should be chosen to avoid conflict with other devices, or
571 put differently, nothing else should be operating on the same
572 frequency while TeleLaunch is in use.</p>
573 </div>
574 </div>
575 </div>
576 <div class="sect1">
577 <h2 id="_updating_firmware">5. Updating Firmware</h2>
578 <div class="sectionbody">
579 <div class="paragraph">
580 <p>The firmware for each unit can be updated over USB.  More details
581 will be forthcoming if/when a firmware update is required.</p>
582 </div>
583 </div>
584 </div>
585 <div class="sect1">
586 <h2 id="_making_pad_cables">Appendix A: Making Pad Cables</h2>
587 <div class="sectionbody">
588 <div class="paragraph">
589 <p>Pad cables can be made from standard AC extension cords and alligator
590 clips&#8230;&#8203;</p>
591 </div>
592 </div>
593 </div>
594 <div class="sect1">
595 <h2 id="_troubleshooting">Appendix B: Troubleshooting</h2>
596 <div class="sectionbody">
597 <div class="sect2">
598 <h3 id="_telefire_fails_to_arm">B.1. TeleFire Fails to Arm</h3>
599 <div class="paragraph">
600 <p>If turning the TeleLCO key switch from "SAFE" to "ARM" does
601 not cause the selected TeleFire box to start flashing and
602 sounding its siren, the most likely cause is that the
603 TeleFire box was left with the local safe/arm switch in the
604 safe position.  The Remote Arm LED on TeleLCO shows the state
605 of the safe/arm switch on the currently selected TeleFire box
606 and can be used to confirm this situation.</p>
607 </div>
608 <div class="paragraph">
609 <p>Note that in a cross-bank drag race configuration, any TeleFire
610 boxes involved in the drag race that are fully armed will
611 launch, while any TeleFire boxes involved in the drag race
612 that are not fully armed will not launch.  Pay attention to
613 make sure all involved TeleFire boxes are flashing their
614 strobe lights and sounding their sirens before launch to
615 ensure all desired rockets will actually participate in such
616 a drag race.</p>
617 </div>
618 </div>
619 <div class="sect2">
620 <h3 id="_radio_signal_strength">B.2. Radio Signal Strength</h3>
621 <div class="paragraph">
622 <p>Each unit in the TeleLaunch system has a debugging feature
623 that can be used to view the actual received radio signal
624 strength of each packet.  To use this feature, connect to the
625 desired unit (TeleLCO is probably the most useful place to
626 start) with a laptop and terminal program as explained in the
627 configuration section of the manual.  Then, you can enable
628 debug tracing using 'D 1' command.</p>
629 </div>
630 <div class="paragraph">
631 <p>Debug mode is fairly chatty, but each time the TeleLCO unit
632 queries the currently selected TeleFire unit for igniter
633 status, the return packet will print out the RSSI value.
634 RSSI is "received signal strength indicated" and is expressed
635 in decibel units relative to a milliwatt, or "dBm".</p>
636 </div>
637 <div class="paragraph">
638 <p>Observing the RSSI is a great way to compare antennas, antenna
639 mounting arrangements, and so forth with more granularity than
640 provided by the red/amber/green operational LED indicators.</p>
641 </div>
642 <div class="paragraph">
643 <p>The system is good down to below -100dBm, and it takes about
644 6dB to double the range.  So a reading of -80dBm means that you
645 could extend the distance between the units by a factor of
646 10 before losing the link.  Note, however, that real world
647 range is affected by terrain, vegetation, etc.  And you really
648 don&#8217;t ever want to be operating close to the minimum signal
649 threshold!  Keep the RF signal indicators green with good
650 antenna choices and installations for maximum satisfaction.</p>
651 </div>
652 </div>
653 </div>
654 </div>
655 </div>
656 <div id="footer">
657 <div id="footer-text">
658 Version v1.9.9<br>
659 Last updated 2021-10-07 00:16:13 -0600
660 </div>
661 </div>
662 </body>
663 </html>