11cd480445da77b39983aa73415021701215aeb2
[web/altusmetrum] / AltOS / doc / telelaunch.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 1.5.8">
8 <meta name="author" content="Bdale Garbee">
9 <meta name="copyright" content="Bdale Garbee 2019">
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 v0.1,</span>
20 <span id="revdate">16 Feb 2019</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="#_radio_signal_strength">B.1. 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 © 2018 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 3 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>
235 <div class="sect2">
236 <h3 id="_callsign">2.5. Callsign</h3>
237 <div class="paragraph">
238 <p>In the US, you need an
239 <a href="http://www.altusmetrum.org/Radio/">amateur radio license</a>
240 or other authorization to legally operate the radio
241 transmitters that are part of TeleLaunch.</p>
242 </div>
243 <div class="paragraph">
244 <p>The default callsign shipped from the factory is "N0CALL",
245 which is not a valid callsign and meant to humorously point
246 out that the callsign hasn&#8217;t been configured yet.</p>
247 </div>
248 <div class="paragraph">
249 <p>Individual owners of a TeleLaunch system should use their
250 own callsign.</p>
251 </div>
252 <div class="paragraph">
253 <p>Club owners of a TeleLaunch system should pick the callsign
254 of one club member who is willing to be designated as the
255 control operator of the system.  Under FCC Part 97 rules,
256 being the control operator does not mean you have to be LCO
257 all the time, it just means taking responsibility for ensuring
258 the system is being operated in compliance with the rules.</p>
259 </div>
260 <div class="paragraph">
261 <p>To configure the callsign, use your terminal emulator to
262 issue two commands.  First, use 'c c callsign' to set the
263 callsign, then use 'c w' to write to non-volatile memory.
264 For example, to set the default N0CALL, the commands would
265 be</p>
266 </div>
267 <div class="paragraph">
268 <p>c c N0CALL<br>
269 c w</p>
270 </div>
271 </div>
272 <div class="sect2">
273 <h3 id="_aes_key">2.6. AES Key</h3>
274 <div class="paragraph">
275 <p>For safety, TeleLaunch uses cryptographic checksums to help
276 prevent interference, intentional or un-intentional.  This
277 means each system must have a shared AES encryption key
278 identically configured into each unit.</p>
279 </div>
280 <div class="paragraph">
281 <p>The key size required is 128 bits, which must be expressed
282 as a 32-digit hexadecimal number.</p>
283 </div>
284 <div class="paragraph">
285 <p>To configure the AES key, use 'c a key' followed by 'c w'
286 to write the key to non-volatile memory.  For example, to
287 configure your system with a key that is the answer to life,
288 the universe, and everything, the commands would be</p>
289 </div>
290 <div class="paragraph">
291 <p>c a 00000000000000000000000000000042<br>
292 c w</p>
293 </div>
294 </div>
295 <div class="sect2">
296 <h3 id="_bank_number">2.7. Bank Number</h3>
297 <div class="paragraph">
298 <p>Each TeleFire unit needs to be configured with a bank number,
299 and bank numbers should be unique within a given system.  For
300 most systems with 8 or less banks, just use the DIP switch
301 on the circuit board inside the TeleFire unit to select the
302 desired bank.  Only one switch should be turned on.  Switch
303 one means bank one, etc.</p>
304 </div>
305 <div class="paragraph">
306 <p>To allow systems to have more than 8 banks, if all the DIP
307 switches are "off", the unit will use the bank configured in
308 non-volatile memory.</p>
309 </div>
310 <div class="paragraph">
311 <p>To configure the bank number, use 'c B bank' followed by
312 'c w' to write to non-volatile memory.  For example, to
313 set the bank to 42, the commands would be:</p>
314 </div>
315 <div class="paragraph">
316 <p>c B 42<br>
317 c w</p>
318 </div>
319 </div>
320 </div>
321 </div>
322 <div class="sect1">
323 <h2 id="_operation">3. Operation</h2>
324 <div class="sectionbody">
325 <div class="paragraph">
326 <p>Operating a TeleLaunch system is pretty easy, and we hope fairly
327 intuitive for anyone who has ever launched rockets before.  Basic
328 instructions are printed on a decal inside the lid of each TeleLCO
329 unit, which early customers (before this manual was even written)
330 reported were sufficient to successfully use the system.</p>
331 </div>
332 <div class="paragraph">
333 <p>The remainder of this section assumes the system has already been
334 properly configured with callsign, AES key, and bank numbers for each
335 TeleFire box.</p>
336 </div>
337 <div class="sect2">
338 <h3 id="_charging_batteries">3.1. Charging Batteries</h3>
339 <div class="paragraph">
340 <p>TeleLCO has an internal Lithium Polymer battery that is
341 charged over USB.  A weather-tight micro USB connector is
342 installed with a blue cap under the handle.  This position
343 was chosen so that TeleLCO can be charged while the lid is
344 closed and standing handle-up.  Attach a micro USB cable
345 to a computer or other source of USB power.  There are two
346 charge indicators on the panel that will illuminate during
347 charging, red for charge in progress and green for charge
348 complete.</p>
349 </div>
350 <div class="paragraph">
351 <p>TeleFire has an internal sealed lead acid 12V battery, and
352 is provided with an external AC charger.  Connect this charger
353 to the PowerPole connector on the back face of the box to
354 charge the battery.  Other sources of charging current for
355 a nominal 12V sealed battery may be used.  The charge
356 connector can also be used to attach an external battery if
357 needed.</p>
358 </div>
359 </div>
360 <div class="sect2">
361 <h3 id="_setting_up">3.2. Setting Up</h3>
362 <div class="paragraph">
363 <p>Each unit in the TeleLaunch system needs a suitable antenna
364 attached.  A typical configuration would involve the provided
365 omni-directional antenna or optional directional antenna aimed
366 at the field mounted on a pole attached to TeleLCO at the
367 launch control station, and the provided rubber whip antennas
368 on each TeleFire box.</p>
369 </div>
370 <div class="paragraph">
371 <p>If deploying the system in rough terrain, on a field with
372 dense vegetation, or at great distances (some away cells), you
373 may need a better antenna or at least to mount the antenna
374 higher off the ground.  All units in the TeleLaunch system
375 have tri-color RF signal strength indicators.  A system should
376 show green on all units during normal operation.  An occasional
377 dip to amber is ok, but frequent amber or any red indicates a
378 need to improve the antenna situation.</p>
379 </div>
380 <div class="paragraph">
381 <p>Antenna made for use near 435 Mhz in the ham radio "70cm band"
382 should work, and there are many online sources of information
383 on making inexpensive, highly effective antennas at home.</p>
384 </div>
385 <div class="paragraph">
386 <p>The TeleLCO unit should be placed on a table at the Launch
387 Control position.  It can be helpful for the LCO (the human(s)
388 too, not just the electronics!) to be provided with some
389 shade, but the use of transreflexive LCDs for the digit
390 displays and ultri-bright LEDs make TeleLCO operation
391 reasonable even in direct sunlight.</p>
392 </div>
393 <div class="paragraph">
394 <p>Each TeleFire box should be placed in proximity to the launch
395 rails it will service.  Whip clips made from AC power cords
396 (not provided) should be attached to TeleFire and routed to
397 each launch rail.  The pyro output on each channel is
398 connected to the "line" and "neutral" pins on the outlet,
399 while the ground pin is attached to chassis ground.</p>
400 </div>
401 </div>
402 <div class="sect2">
403 <h3 id="_turning_system_on">3.3. Turning System On</h3>
404 <div class="paragraph">
405 <p>Turn on all TeleFire pad boxes in the system.  At power-on,
406 all LEDs will turn on briefly so you can verify they&#8217;re all
407 working.  The radio signal strength indicators will show red
408 until TeleLCO is turned on.</p>
409 </div>
410 <div class="paragraph">
411 <p>Turn on TeleLCO.  All LCD segments and LEDs will turn on
412 briefly so you can verify they&#8217;re all working.  An exception
413 are the two battery charger LEDs, which only illuminate when
414 the battery is charging.  The LCD displays will then briefly
415 display the internal battery voltage, which should be at least
416 3.9V for normal operation.  TeleLCO then scans to locate all
417 TeleFire boxes that are in range and configured for the same
418 frequency, callsign, and AES key.  During this process, the
419 Bank LCD diplays will appear to be counting up from 1 to 99.
420 When the search is complete, the Pad display will show the
421 number of TeleFire devices found.  TeleLCO beeps when ready.</p>
422 </div>
423 </div>
424 <div class="sect2">
425 <h3 id="_launch_one_rocket">3.4. Launch One Rocket</h3>
426 <div class="paragraph">
427 <p>Switch the TeleFire to 'Safe' and confirm it is silent.</p>
428 </div>
429 <div class="paragraph">
430 <p>Put a rocket on a launch rail / rod, and connect whip clips
431 from a pad output on a TeleFire unit to the motor igniter.
432 Verify igniter continuity using the LED associated with that
433 output.  Green is good, red is bad.</p>
434 </div>
435 <div class="paragraph">
436 <p>Switch the TeleFire unit from 'Safe' to 'Arm', at which point
437 it will start "chirping" to indicate that it is "armed and
438 dangerous".  Move to the TeleLCO at a safe distance away.</p>
439 </div>
440 <div class="paragraph">
441 <p>Ensure the TeleLCO blue Drag Race switch is on Normal and
442 the blue Drag Race LED is extinguished.</p>
443 </div>
444 <div class="paragraph">
445 <p>Select the desired TeleFire unit by pushing the TeleLCO
446 selector knob until the "Bank" LED is lit, then rotating the
447 knob until the
448 desired box is selected.  Then push the knob until the Pad
449 LED is lit and rotate the knob until the desired pad is
450 selected.  Verify the Remote Armed LED is lit, and that the
451 selected pad&#8217;s Igniter Continuity LED is lit.</p>
452 </div>
453 <div class="paragraph">
454 <p>Perform range safety checks.</p>
455 </div>
456 <div class="paragraph">
457 <p>Move the TeleLCO SAFE/ARM switch to ARM.  This will cause
458 the selected TeleFire unit&#8217;s strobe to start flashing and
459 siren to become more insistent.</p>
460 </div>
461 <div class="paragraph">
462 <p>Perform count-down.</p>
463 </div>
464 <div class="paragraph">
465 <p>Depress the LAUNCH button and hold until the rocket launches.</p>
466 </div>
467 <div class="paragraph">
468 <p>Move the TeleLCO SAFE/ARM switch back to SAFE.</p>
469 </div>
470 </div>
471 <div class="sect2">
472 <h3 id="_launch_a_multi_rocket_drag_race">3.5. Launch A Multi-Rocket "Drag Race"</h3>
473 <div class="paragraph">
474 <p>To enable drag race mode, move the TeleLCO blue switch to
475 Drag Race.  The blue Drag Race LED should illuminate.</p>
476 </div>
477 <div class="paragraph">
478 <p>Select pads to include in the drag race by using the same
479 process as for a single rocket to select each Bank and Pad,
480 then press Add/Remove to toggle the currently selected pad
481 in the race.  The continuity LEDs blink ON/off for selected,
482 and on/OFF for deselected (long ON means in the race).</p>
483 </div>
484 <div class="paragraph">
485 <p>A drag race can be configured to include pads on multiple
486 TeleFire boxes, but the blinking continuity indicators to
487 show which pads are included can only indicate the currently
488 selected bank.</p>
489 </div>
490 <div class="paragraph">
491 <p>Verify remotes are ready and armed by using the Remote Armed
492 and Igniter Continuity LEDs.</p>
493 </div>
494 <div class="paragraph">
495 <p>Perform range safety checks.</p>
496 </div>
497 <div class="paragraph">
498 <p>Move the TeleLCO SAFE/ARM switch to ARM.  This will cause
499 the selected TeleFire units strobes to start flashing and
500 sirens to become more insistent.</p>
501 </div>
502 <div class="paragraph">
503 <p>Perform count-down.</p>
504 </div>
505 <div class="paragraph">
506 <p>Depress the LAUNCH button and hold until rockets launch.</p>
507 </div>
508 <div class="paragraph">
509 <p>Move the TeleLCO SAFE/ARM switch back to SAFE.</p>
510 </div>
511 <div class="paragraph">
512 <p>Move Drag Race switch back to Normal.</p>
513 </div>
514 <div class="paragraph">
515 <p>Note that if there is a mis-fire in a drag race and you want
516 to fix igniters and try again, the current drag configuration
517 is preserved as long as you stay in Drag Race mode.  So you
518 can SAFE the system, fix igniters, and try again before leaving
519 Drag Race mode if desired.</p>
520 </div>
521 </div>
522 </div>
523 </div>
524 <div class="sect1">
525 <h2 id="_specifications">4. Specifications</h2>
526 <div class="sectionbody">
527 <div class="paragraph">
528 <p>The TeleLaunch system can handle up to 99 banks with each bank
529 having up to 8 pads, for a total of 792 pads.</p>
530 </div>
531 <div class="paragraph">
532 <p>Each unit in the TeleLaunch system is water-resistant, but is not
533 intended to be directly immersed in water.  Brief rain showers during
534 a launch should pose no problem, but it&#8217;s recommended to cover units
535 or bring them inside when not in use or during extended periods of
536 bad weather.</p>
537 </div>
538 <div class="paragraph">
539 <p>TeleLCO uses an internal single-cell 2Ah Lithium Polymer battery,
540 which is sufficient for multiple days of typical operation.  This
541 battery is charged over USB.</p>
542 </div>
543 <div class="paragraph">
544 <p>TeleFire uses an internal sealed lead-acid 12V battery, which is
545 charged by an external charger attached through the PowerPole
546 connector on the rear panel.</p>
547 </div>
548 <div class="paragraph">
549 <p>Pyro initiation uses the 12V sealed lead-acid battery.  Current
550 to any pad can exceed 30A, and with typical igniters every pad on
551 a TeleFire can be successfully included in a drag race.  The system
552 controls current flow to prevent damage, and has a self-resetting
553 circuit breaker for ultimate protection should something go badly
554 wrong.</p>
555 </div>
556 <div class="paragraph">
557 <p>TeleLaunch uses AES encryption with a shared key between each unit
558 in the system to ensure the integrity of safe launch operations.</p>
559 </div>
560 <div class="paragraph">
561 <p>The TeleLaunch system uses radio frequency communications in the
562 vicinity of 435 Mhz.  A US amateur radio license or equivalent
563 authorization is required to legally use the system.  The operating
564 frequency should be chosen to avoid conflict with other devices, or
565 put differently, nothing else should be operating on the same
566 frequency while TeleLaunch is in use.</p>
567 </div>
568 </div>
569 </div>
570 <div class="sect1">
571 <h2 id="_updating_firmware">5. Updating Firmware</h2>
572 <div class="sectionbody">
573 <div class="paragraph">
574 <p>The firmware for each unit can be updated over USB.  More details
575 will be forthcoming if/when a firmware update is required.</p>
576 </div>
577 </div>
578 </div>
579 <div class="sect1">
580 <h2 id="_making_pad_cables">Appendix A: Making Pad Cables</h2>
581 <div class="sectionbody">
582 <div class="paragraph">
583 <p>Pad cables can be made from standard AC extension cords and alligator
584 clips&#8230;&#8203;</p>
585 </div>
586 </div>
587 </div>
588 <div class="sect1">
589 <h2 id="_troubleshooting">Appendix B: Troubleshooting</h2>
590 <div class="sectionbody">
591 <div class="sect2">
592 <h3 id="_radio_signal_strength">B.1. Radio Signal Strength</h3>
593 <div class="paragraph">
594 <p>Each unit in the TeleLaunch system has a debugging feature
595 that can be used to view the actual received radio signal
596 strength of each packet.  To use this feature, connect to the
597 desired unit (TeleLCO is probably the most useful place to
598 start) with a laptop and terminal program as explained in the
599 configuration section of the manual.  Then, you can enable
600 debug tracing using 'D 1' command.</p>
601 </div>
602 <div class="paragraph">
603 <p>Debug mode is fairly chatty, but each time the TeleLCO unit
604 queries the currently selected TeleFire unit for igniter
605 status, the return packet will print out the RSSI value.
606 RSSI is "received signal strength indicated" and is expressed
607 in decibel units relative to a milliwatt, or "dBm".</p>
608 </div>
609 <div class="paragraph">
610 <p>Observing the RSSI is a great way to compare antennas, antenna
611 mounting arrangements, and so forth with more granularity than
612 provided by the red/amber/green operational LED indicators.</p>
613 </div>
614 <div class="paragraph">
615 <p>The system is good down to about -100dBm, and it takes about
616 6dB to double the range.  So a reading of -84dBm means that you
617 could extend the distance between the units by a factor of
618 10 before losing the link.  Note, however, that real world
619 range is affected by terrain, vegetation, etc.</p>
620 </div>
621 </div>
622 </div>
623 </div>
624 </div>
625 <div id="footer">
626 <div id="footer-text">
627 Version v0.1<br>
628 Last updated 2019-02-21 17:09:16 -0700
629 </div>
630 </div>
631 </body>
632 </html>