path: root/doc/altosui.inc

== AltosUI

	.AltosUI Main Window
	image::altosui.png[width="4.6in"]

	The AltosUI program provides a graphical user interface for
	interacting with the Altus Metrum product family. AltosUI can
	monitor telemetry data, configure devices and many other
	tasks. The primary interface window provides a selection of
	buttons, one for each major activity in the system.  This
	chapter is split into sections, each of which documents one of
	the tasks provided from the top-level toolbar.

    	=== Monitor Flight
	////
	      <subtitle>Receive, Record and Display Telemetry Data</subtitle>
	////

		Selecting this item brings up a dialog box listing all
		of the connected TeleDongle devices. When you choose
		one of these, AltosUI will create a window to display
		telemetry data as received by the selected TeleDongle
		device.

		.Device Selection Dialog
		image::device-selection.png[width="3.1in"]

		All telemetry data received are automatically recorded
		in suitable log files. The name of the files includes
		the current date and rocket serial and flight numbers.

		The radio frequency being monitored by the TeleDongle
		device is displayed at the top of the window. You can
		configure the frequency by clicking on the frequency
		box and selecting the desired frequency. AltosUI
		remembers the last frequency selected for each
		TeleDongle and selects that automatically the next
		time you use that device.

		Below the TeleDongle frequency selector, the window
		contains a few significant pieces of information about
		the altimeter providing the telemetry data stream:

		 * The configured call-sign

		 * The device serial number

		 * The flight number. Each altimeter remembers how
		   many times it has flown.

		 * The rocket flight state. Each flight passes through
		   several states including Pad, Boost, Fast, Coast,
		   Drogue, Main and Landed.

		 * The Received Signal Strength Indicator value. This
		   lets you know how strong a signal TeleDongle is
		   receiving. At the default data rate, 38400 bps, in
		   bench testing, the radio inside TeleDongle v0.2
		   operates down to about -106dBm, while the v3 radio
		   works down to about -111dBm.  Weaker signals, or an
		   environment with radio noise may cause the data to
		   not be received. The packet link uses error
		   detection and correction techniques which prevent
		   incorrect data from being reported.

		 * The age of the displayed data, in seconds since the
		   last successfully received telemetry packet.  In
		   normal operation this will stay in the low single
		   digits.  If the number starts counting up, then you
		   are no longer receiving data over the radio link
		   from the flight computer.

		Finally, the largest portion of the window contains a
		set of tabs, each of which contain some information
		about the rocket.  They're arranged in 'flight order'
		so that as the flight progresses, the selected tab
		automatically switches to display data relevant to the
		current state of the flight. You can select other tabs
		at any time. The final 'table' tab displays all of the
		raw telemetry values in one place in a
		spreadsheet-like format.

		==== Launch Pad

			.Monitor Flight Launch Pad View
			image::launch-pad.png[width="5.5in"]

			The 'Launch Pad' tab shows information used to decide when the
			rocket is ready for flight. The first elements include red/green
			indicators, if any of these is red, you'll want to evaluate
			whether the rocket is ready to launch:

			Battery Voltage::
			This indicates whether the Li-Po battery powering the
			flight computer has sufficient charge to last for
			the duration of the flight. A value of more than
			3.8V is required for a 'GO' status.

			Apogee Igniter Voltage::
			This indicates whether the apogee
			igniter has continuity. If the igniter has a low
			resistance, then the voltage measured here will be close
			to the Li-Po battery voltage. A value greater than 3.2V is
			required for a 'GO' status.

			Main Igniter Voltage::
			This indicates whether the main
			igniter has continuity. If the igniter has a low
			resistance, then the voltage measured here will be close
			to the Li-Po battery voltage. A value greater than 3.2V is
			required for a 'GO' status.

			On-board Data Logging::
			This indicates whether there is space remaining
			on-board to store flight data for the upcoming
			flight. If you've downloaded data, but failed to erase
			flights, there may not be any space left. Most of our
			flight computers can store multiple flights, depending
			on the configured maximum flight log size. TeleMini
			v1.0 stores only a single flight, so it will need to
			be downloaded and erased after each flight to capture
			data. This only affects on-board flight logging; the
			altimeter will still transmit telemetry and fire
			ejection charges at the proper times even if the
			flight data storage is full.

			GPS Locked::
			For a TeleMetrum or TeleMega device, this indicates
			whether the GPS receiver is currently able to compute
			position information. GPS requires at least 4
			satellites to compute an accurate position.

			GPS Ready::

			For a TeleMetrum or TeleMega device, this indicates
			whether GPS has reported at least 10 consecutive
			positions without losing lock. This ensures that the
			GPS receiver has reliable reception from the
			satellites.

			The Launchpad tab also shows the computed launch pad
			position and altitude, averaging many reported
			positions to improve the accuracy of the fix.

		==== Ascent

			.Monitor Flight Ascent View
			image::ascent.png[width="5.5in"]

			This tab is shown during Boost, Fast and Coast
			phases. The information displayed here helps monitor the
			rocket as it heads towards apogee.

			The height, speed, acceleration and tilt are shown along
			with the maximum values for each of them. This allows you to
			quickly answer the most commonly asked questions you'll hear
			during flight.

			The current latitude and longitude reported by the GPS are
			also shown. Note that under high acceleration, these values
			may not get updated as the GPS receiver loses position
			fix. Once the rocket starts coasting, the receiver should
			start reporting position again.

			Finally, the current igniter voltages are reported as in the
			Launch Pad tab. This can help diagnose deployment failures
			caused by wiring which comes loose under high acceleration.

		==== Descent

			.Monitor Flight Descent View
			image::descent.png[width="5.5in"]

			Once the rocket has reached apogee and (we hope)
			activated the apogee charge, attention switches to
			tracking the rocket on the way back to the ground, and
			for dual-deploy flights, waiting for the main charge
			to fire.

			To monitor whether the apogee charge operated
			correctly, the current descent rate is reported along
			with the current height. Good descent rates vary based
			on the choice of recovery components, but generally
			range from 15-30m/s on drogue and should be below
			10m/s when under the main parachute in a dual-deploy
			flight.

			With GPS-equipped flight computers, you can locate the
			rocket in the sky using the elevation and bearing
			information to figure out where to look. Elevation is
			in degrees above the horizon. Bearing is reported in
			degrees relative to true north. Range can help figure
			out how big the rocket will appear. Ground Distance
			shows how far it is to a point directly under the
			rocket and can help figure out where the rocket is
			likely to land. Note that all of these values are
			relative to the pad location. If the elevation is near
			90°, the rocket is over the pad, not over you.

			Finally, the igniter voltages are reported in this tab
			as well, both to monitor the main charge as well as to
			see what the status of the apogee charge is.  Note
			that some commercial e-matches are designed to retain
			continuity even after being fired, and will continue
			to show as green or return from red to green after
			firing.

		==== Landed

			.Monitor Flight Landed View
			image::landed.png[width="5.5in"]

			Once the rocket is on the ground, attention switches
			to recovery. While the radio signal is often lost once
			the rocket is on the ground, the last reported GPS
			position is generally within a short distance of the
			actual landing location.

			The last reported GPS position is reported both by
			latitude and longitude as well as a bearing and
			distance from the launch pad. The distance should give
			you a good idea of whether to walk or hitch a ride.
			Take the reported latitude and longitude and enter
			them into your hand-held GPS unit and have that
			compute a track to the landing location.

			Our flight computers will continue to transmit RDF
			tones after landing, allowing you to locate the rocket
			by following the radio signal if necessary. You may
			need to get away from the clutter of the flight line,
			or even get up on a hill (or your neighbor's RV roof)
			to receive the RDF signal.

			The maximum height, speed and acceleration reported
			during the flight are displayed for your admiring
			observers.  The accuracy of these immediate values
			depends on the quality of your radio link and how many
			packets were received.  Recovering the on-board data
			after flight may yield more precise results.

			To get more detailed information about the flight, you
			can click on the 'Graph Flight' button which will
			bring up a graph window for the current flight.

		==== Table

			.Monitor Flight Table View
			image::table.png[width="5.5in"]

			The table view shows all of the data available from the
			flight computer. Probably the most useful data on
			this tab is the detailed GPS information, which includes
			horizontal dilution of precision information, and
			information about the signal being received from the satellites.

		==== Site Map

			.Monitor Flight Site Map View
			image::site-map.png[width="5.5in"]

			When the TeleMetrum has a GPS fix, the Site Map tab
			will map the rocket's position to make it easier for
			you to locate the rocket, both while it is in the air,
			and when it has landed. The rocket's state is
			indicated by color: white for pad, red for boost, pink
			for fast, yellow for coast, light blue for drogue,
			dark blue for main, and black for landed.

			The map's default scale is approximately 3m (10ft) per
			pixel. The map can be dragged using the left mouse
			button. The map will attempt to keep the rocket
			roughly centered while data is being received.

			You can adjust the style of map and the zoom level
			with buttons on the right side of the map window. You
			can draw a line on the map by moving the mouse over
			the map with a button other than the left one pressed,
			or by pressing the left button while also holding down
			the shift key. The length of the line in real-world
			units will be shown at the start of the line.

			Images are fetched automatically via the Google Maps
			Static API, and cached on disk for reuse. If map
			images cannot be downloaded, the rocket's path will be
			traced on a dark gray background instead.

			You can pre-load images for your favorite launch sites
			before you leave home; check out the 'Preload Maps'
			section below.

		==== Igniter

			.Monitor Flight Additional Igniter View
			image::ignitor.png[width="5.5in"]

			TeleMega includes four additional programmable pyro
			channels. The Ignitor tab shows whether each of them has
			continuity. If an ignitor has a low resistance, then the
			voltage measured here will be close to the pyro battery
			voltage. A value greater than 3.2V is required for a 'GO'
			status.

	=== Save Flight Data

		The altimeter records flight data to its internal
		flash memory.  TeleMetrum data is recorded at a much
		higher rate than the telemetry system can handle, and
		is not subject to radio drop-outs. As such, it
		provides a more complete and precise record of the
		flight. The 'Save Flight Data' button allows you to
		read the flash memory and write it to disk.

		Clicking on the 'Save Flight Data' button brings up a
		list of connected flight computers and TeleDongle
		devices. If you select a flight computer, the flight
		data will be downloaded from that device directly. If
		you select a TeleDongle device, flight data will be
		downloaded from a flight computer over radio link via
		the specified TeleDongle. See the chapter on
		Controlling An Altimeter Over The Radio Link for more
		information.

		After the device has been selected, a dialog showing
		the flight data saved in the device will be shown
		allowing you to select which flights to download and
		which to delete. With version 0.9 or newer firmware,
		you must erase flights in order for the space they
		consume to be reused by another flight. This prevents
		accidentally losing flight data if you neglect to
		download data before flying again. Note that if there
		is no more space available in the device, then no data
		will be recorded during the next flight.

		The file name for each flight log is computed
		automatically from the recorded flight date, altimeter
		serial number and flight number information.

	=== Replay Flight

		Select this button and you are prompted to select a flight
		record file, either a .telem file recording telemetry data or a
		.eeprom file containing flight data saved from the altimeter
		flash memory.

		Once a flight record is selected, the flight monitor interface
		is displayed and the flight is re-enacted in real time. Check
		the Monitor Flight chapter above to learn how this window operates.

	=== Graph Data

		Select this button and you are prompted to select a flight
		record file, either a .telem file recording telemetry data or a
		.eeprom file containing flight data saved from
		flash memory.

		Note that telemetry files will generally produce poor graphs
		due to the lower sampling rate and missed telemetry packets.
		Use saved flight data in .eeprom files for graphing where possible.

		Once a flight record is selected, a window with multiple tabs is
		opened.

		==== Flight Graph

			.Flight Data Graph
			image::graph.png[width="5.5in"]

			By default, the graph contains acceleration (blue),
			velocity (green) and altitude (red).

			The graph can be zoomed into a particular area by
			clicking and dragging down and to the right. Once
			zoomed, the graph can be reset by clicking and
			dragging up and to the left. Holding down control and
			clicking and dragging allows the graph to be panned.
			The right mouse button causes a pop-up menu to be
			displayed, giving you the option save or print the
			plot.

		==== Configure Graph

			.Flight Graph Configuration
			image::graph-configure.png[width="5.5in"]

			This selects which graph elements to show, and, at the
			very bottom, lets you switch between metric and
			imperial units

		==== Flight Statistics

			.Flight Statistics
			image::graph-stats.png[width="5.5in"]

			Shows overall data computed from the flight.

		==== Map

			.Flight Map
			image::graph-map.png[width="5.5in"]

			Shows a satellite image of the flight area overlaid
			with the path of the flight. The red concentric
			circles mark the launch pad, the black concentric
			circles mark the landing location.

	=== Export Data

		This tool takes the raw data files and makes them
		available for external analysis. When you select this
		button, you are prompted to select a flight data file,
		which can be either a .eeprom or .telem.  The .eeprom
		files contain higher resolution and more continuous
		data, while .telem files contain receiver signal
		strength information.  Next, a second dialog appears
		which is used to select where to write the resulting
		file. It has a selector to choose between CSV and KML
		file formats.

		==== Comma Separated Value Format

			This is a text file containing the data in a form
			suitable for import into a spreadsheet or other
			external data analysis tool. The first few lines of
			the file contain the version and configuration
			information from the altimeter, then there is a single
			header line which labels all of the fields. All of
			these lines start with a '#' character which many
			tools can be configured to skip over.

			The remaining lines of the file contain the data, with
			each field separated by a comma and at least one
			space. All of the sensor values are converted to
			standard units, with the barometric data reported in
			both pressure, altitude and height above pad units.

		==== Keyhole Markup Language (for Google Earth)

			This is the format used by Google Earth to provide an
			overlay within that application. With this, you can
			use Google Earth to see the whole flight path in 3D.

	=== Configure Altimeter

		.Altimeter Configuration
		image::configure-altimeter.png[width="3.6in"]

		Select this button and then select either an altimeter or
		TeleDongle Device from the list provided. Selecting a TeleDongle
		device will use the radio link to configure a remote altimeter.

		The first few lines of the dialog provide information about the
		connected device, including the product name,
		software version and hardware serial number. Below that are the
		individual configuration entries.

		At the bottom of the dialog, there are four buttons:

		Save::
		This writes any changes to the configuration parameter
		block in flash memory. If you don't press this button,
		any changes you make will be lost.

		Reset::
		This resets the dialog to the most recently saved
		values, erasing any changes you have made.

		Reboot::

		This reboots the device. Use this to switch from idle
		to pad mode by rebooting once the rocket is oriented
		for flight, or to confirm changes you think you saved
		are really saved.

		Close::

		This closes the dialog. Any unsaved changes will be
		lost.

	        The rest of the dialog contains the parameters to be configured.

		==== Main Deploy Altitude

			This sets the altitude (above the recorded pad
			altitude) at which the 'main' igniter will fire. The
			drop-down menu shows some common values, but you can
			edit the text directly and choose whatever you
			like. If the apogee charge fires below this altitude,
			then the main charge will fire two seconds after the
			apogee charge fires.

		==== Apogee Delay

			When flying redundant electronics, it's often
			important to ensure that multiple apogee charges don't
			fire at precisely the same time, as that can over
			pressurize the apogee deployment bay and cause a
			structural failure of the air-frame. The Apogee Delay
			parameter tells the flight computer to fire the apogee
			charge a certain number of seconds after apogee has
			been detected.

		==== Apogee Lockout

			Apogee lockout is the number of seconds after boost
			where the flight computer will not fire the apogee
			charge, even if the rocket appears to be at
			apogee. This is often called 'Mach Delay', as it is
			intended to prevent a flight computer from
			unintentionally firing apogee charges due to the
			pressure spike that occurrs across a mach
			transition. Altus Metrum flight computers include a
			Kalman filter which is not fooled by this sharp
			pressure increase, and so this setting should be left
			at the default value of zero to disable it.

		==== Frequency

			This configures which of the frequencies to use for
			both telemetry and packet command mode. Note that if
			you set this value via packet command mode, the
			TeleDongle frequency will also be automatically
			reconfigured to match so that communication will
			continue afterwards.

		==== RF Calibration

			The radios in every Altus Metrum device are calibrated
			at the factory to ensure that they transmit and
			receive on the specified frequency.  If you need to
			you can adjust the calibration by changing this value.
			Do not do this without understanding what the value
			means, read the appendix on calibration and/or the
			source code for more information.  To change a
			TeleDongle's calibration, you must reprogram the unit
			completely.

      		==== Telemetry/RDF/APRS Enable

			Enables the radio for transmission during
			flight. When disabled, the radio will not
			transmit anything during flight at all.

      		==== Telemetry baud rate

			This sets the modulation bit rate for data
			transmission for both telemetry and packet
			link mode. Lower bit rates will increase range
			while reducing the amount of data that can be
			sent and increasing battery consumption. All
			telemetry is done using a rate 1/2 constraint
			4 convolution code, so the actual data
			transmission rate is 1/2 of the modulation bit
			rate specified here.

      		==== APRS Interval

			How often to transmit GPS information via APRS
			(in seconds). When set to zero, APRS
			transmission is disabled. This option is
			available on TeleMetrum v2 and TeleMega
			boards. TeleMetrum v1 boards cannot transmit
			APRS packets. Note that a single APRS packet
			takes nearly a full second to transmit, so
			enabling this option will prevent sending any
			other telemetry during that time.

      		==== APRS SSID

			Which SSID to report in APRS packets. By
			default, this is set to the last digit of the
			serial number, but can be configured to any
			value from 0 to 9.

		==== Callsign

			This sets the call sign included in each
			telemetry packet. Set this as needed to
			conform to your local radio regulations.

      		==== Maximum Flight Log Size

			This sets the space (in kilobytes) allocated
			for each flight log. The available space will
			be divided into chunks of this size. A smaller
			value will allow more flights to be stored, a
			larger value will record data from longer
			flights.

      		==== Ignitor Firing Mode

			This configuration parameter allows the two standard ignitor
			channels (Apogee and Main) to be used in different
			configurations.

			Dual Deploy::
			This is the usual mode of operation; the
			'apogee' channel is fired at apogee and the
			'main' channel at the height above ground
			specified by the 'Main Deploy Altitude' during
			descent.

			Redundant Apogee::
			This fires both channels at apogee, the
			'apogee' channel first followed after a two
			second delay by the 'main' channel.

			Redundant Main::
			This fires both channels at the height above
			ground specified by the Main Deploy Altitude
			setting during descent. The 'apogee' channel
			is fired first, followed after a two second
			delay by the 'main' channel.

      		==== Pad Orientation

			Because they include accelerometers,
			TeleMetrum, TeleMega and EasyMega are
			sensitive to the orientation of the board. By
			default, they expect the antenna end to point
			forward. This parameter allows that default to
			be changed, permitting the board to be mounted
			with the antenna pointing aft instead.

			Antenna Up::
			In this mode, the antenna end of the flight
			computer must point forward, in line with the
			expected flight path.

			Antenna Down::
			In this mode, the antenna end of the flight
			computer must point aft, in line with the
			expected flight path.

      		==== Beeper Frequency

			The beeper on all Altus Metrum flight
			computers works best at 4000Hz, however if you
			have more than one flight computer in a single
			airframe, having all of them sound at the same
			frequency can be confusing. This parameter
			lets you adjust the base beeper frequency
			value.

      		==== Configure Pyro Channels

			.Additional Pyro Channel Configuration
			image::configure-pyro.png[width="5.5in"]

			This opens a separate window to configure the
			additional pyro channels available on TeleMega
			and EasyMega.  One column is presented for
			each channel. Each row represents a single
			parameter, if enabled the parameter must meet
			the specified test for the pyro channel to be
			fired.

			Select conditions and set the related value;
			the pyro channel will be activated when *all*
			of the conditions are met. Each pyro channel
			has a separate set of configuration values, so
			you can use different values for the same
			condition with different channels.

			At the bottom of the window, the 'Pyro Firing
			Time' configuration sets the length of time
			(in seconds) which each of these pyro channels
			will fire for.

			Once you have selected the appropriate
			configuration for all of the necessary pyro
			channels, you can save the pyro configuration
			along with the rest of the flight computer
			configuration by pressing the 'Save' button in
			the main Configure Flight Computer window.

			include::pyro-channels.raw[]

	=== Configure AltosUI

		.Configure AltosUI Dialog
		image::configure-altosui.png[width="2.4in"]

		This button presents a dialog so that you can
		configure the AltosUI global settings.

            	==== Voice Settings

			AltosUI provides voice announcements during
			flight so that you can keep your eyes on the
			sky and still get information about the
			current flight status. However, sometimes you
			don't want to hear them.

			Enable::
			Turns all voice announcements on and off

			Test Voice::
			Plays a short message allowing you to verify
			that the audio system is working and the volume settings
			are reasonable

      		==== Log Directory

			AltosUI logs all telemetry data and saves all
			TeleMetrum flash data to this directory. This
			directory is also used as the staring point
			when selecting data files for display or
			export.

			Click on the directory name to bring up a
			directory choosing dialog, select a new
			directory and click 'Select Directory' to
			change where AltosUI reads and writes data
			files.

      		==== Callsign

			This value is transmitted in each command
			packet sent from TeleDongle and received from
			an altimeter.  It is not used in telemetry
			mode, as the callsign configured in the
			altimeter board is included in all telemetry
			packets.  Configure this with the AltosUI
			operators call sign as needed to comply with
			your local radio regulations.

			Note that to successfully command a flight
			computer over the radio (to configure the
			altimeter, monitor idle, or fire pyro
			charges), the callsign configured here must
			exactly match the callsign configured in the
			flight computer.  This matching is case
			sensitive.

		==== Imperial Units

			This switches between metric units (meters)
			and imperial units (feet and miles). This
			affects the display of values use during
			flight monitoring, configuration, data
			graphing and all of the voice
			announcements. It does not change the units
			used when exporting to CSV files, those are
			always produced in metric units.

		==== Font Size

			Selects the set of fonts used in the flight
			monitor window. Choose between the small,
			medium and large sets.

      		==== Serial Debug

			This causes all communication with a connected
			device to be dumped to the console from which
			AltosUI was started. If you've started it from
			an icon or menu entry, the output will simply
			be discarded. This mode can be useful to debug
			various serial communication issues.

		==== Manage Frequencies

			This brings up a dialog where you can
			configure the set of frequencies shown in the
			various frequency menus. You can add as many
			as you like, or even reconfigure the default
			set. Changing this list does not affect the
			frequency settings of any devices, it only
			changes the set of frequencies shown in the
			menus.

	=== Configure Groundstation

		.Configure Groundstation Dialog
		image::configure-groundstation.png[width="3.1in"]

		Select this button and then select a TeleDongle or
		TeleBT Device from the list provided.

		The first few lines of the dialog provide information
		about the connected device, including the product
		name, software version and hardware serial
		number. Below that are the individual configuration
		entries.

		Note that TeleDongle and TeleBT don't save any
		configuration data, the settings here are recorded on
		the local machine in the Java preferences
		database. Moving the device to another machine, or
		using a different user account on the same machine
		will cause settings made here to have no effect.

		At the bottom of the dialog, there are three
		buttons:

		Save::
		This writes any changes to the local Java
		preferences file. If you don't press this
		button, any changes you make will be lost.

		Reset::
		This resets the dialog to the most recently
		saved values, erasing any changes you have
		made.

		Close::
		This closes the dialog. Any unsaved changes
		will be lost.

		The rest of the dialog contains the parameters
		to be configured.

		==== Frequency

			This configures the frequency to use for both
			telemetry and packet command mode. Set this
			before starting any operation involving packet
			command mode so that it will use the right
			frequency. Telemetry monitoring mode also
			provides a menu to change the frequency, and
			that menu also sets the same Java preference
			value used here.

		==== RF Calibration

			The radios in every Altus Metrum device are
			calibrated at the factory to ensure that they
			transmit and receive on the specified
			frequency.  To change a TeleDongle or TeleBT's
			calibration, you must reprogram the unit
			completely, so this entry simply shows the
			current value and doesn't allow any changes.

	      	==== Telemetry Rate

			This lets you match the telemetry and packet
			link rate from the transmitter. If they don't
			match, the device won't receive any data.

	=== Flash Image

		This reprograms Altus Metrum devices with new
		firmware. TeleMetrum v1.x, TeleDongle v0.2, TeleMini
		and TeleBT are all reprogrammed by using another
		similar unit as a programming dongle (pair
		programming). TeleMega, EasyMega, TeleMetrum v2,
		EasyMini and TeleDongle v3 are all programmed directly
		over their USB ports (self programming).  Please read
		the directions for flashing devices in the Updating
		Device Firmware chapter below.

	=== Fire Igniter

		.Fire Igniter Window
		image::fire-igniter.png[width="1.2in"]

		This activates the igniter circuits in the flight
		computer to help test recovery systems
		deployment. Because this command can operate over the
		Packet Command Link, you can prepare the rocket as for
		flight and then test the recovery system without
		needing to snake wires inside the air-frame.

		Selecting the 'Fire Igniter' button brings up the
		usual device selection dialog. Pick the desired
		device. This brings up another window which shows the
		current continuity test status for all of the pyro
		channels.

		Next, select the desired igniter to fire. This will
		enable the 'Arm' button.

		Select the 'Arm' button. This enables the 'Fire'
		button. The word 'Arm' is replaced by a countdown
		timer indicating that you have 10 seconds to press the
		'Fire' button or the system will deactivate, at which
		point you start over again at selecting the desired
		igniter.

	=== Scan Channels

		.Scan Channels Window
		image::scan-channels.png[width="3.2in"]

		This listens for telemetry packets on all of the
		configured frequencies, displaying information about
		each device it receives a packet from. You can select
		which of the baud rates and telemetry formats should
		be tried; by default, it only listens at 38400 baud
		with the standard telemetry format used in v1.0 and
		later firmware.

	=== Load Maps

		.Load Maps Window
		image::load-maps.png[width="5.2in"]

		Before heading out to a new launch site, you can use
		this to load satellite images in case you don't have
		internet connectivity at the site.

		There's a drop-down menu of launch sites we know
		about; if your favorites aren't there, please let us
		know the lat/lon and name of the site. The contents of
		this list are actually downloaded from our server at
		run-time, so as new sites are sent in, they'll get
		automatically added to this list.  If the launch site
		isn't in the list, you can manually enter the lat/lon
		values

		There are four different kinds of maps you can view;
		you can select which to download by selecting as many
		as you like from the available types:

		Hybrid::
		A combination of satellite imagery and road data. This
		is the default view.

		Satellite::
		Just the satellite imagery without any annotation.

		Roadmap::
		Roads, political boundaries and a few geographic
		features.

		Terrain::
		Contour intervals and shading that show hills and
		valleys.

		You can specify the range of zoom levels to download;
		smaller numbers show more area with less
		resolution. The default level, 0, shows about
		3m/pixel. One zoom level change doubles or halves that
		number. Larger zoom levels show more detail, smaller
		zoom levels less.

		The Map Radius value sets how large an area around the
		center point to download. Select a value large enough
		to cover any plausible flight from that site. Be aware
		that loading a large area with a high maximum zoom
		level can attempt to download a lot of data. Loading
		hybrid maps with a 10km radius at a minimum zoom of -2
		and a maximum zoom of 2 consumes about 120MB of
		space. Terrain and road maps consume about 1/10 as
		much space as satellite or hybrid maps.

		Clicking the 'Load Map' button will fetch images from
		Google Maps; note that Google limits how many images
		you can fetch at once, so if you load more than one
		launch site, you may get some gray areas in the map
		which indicate that Google is tired of sending data to
		you. Try again later.

	=== Monitor Idle

		.Monitor Idle Window
		image::monitor-idle.png[width="5.2in"]

		This brings up a dialog similar to the Monitor Flight
		UI, except it works with the altimeter in “idle” mode
		by sending query commands to discover the current
		state rather than listening for telemetry
		packets. Because this uses command mode, it needs to
		have the TeleDongle and flight computer callsigns
		match exactly. If you can receive telemetry, but
		cannot manage to run Monitor Idle, then it's very
		likely that your callsigns are different in some way.

		You can change the frequency and callsign used to
		communicate with the flight computer; they must both
		match the configuration in the flight computer
		exactly.