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