updated to work with new gcc and avrlibc
[openmag.git] / doc / DUSIDatasheet.texi
blob42b93b01ef46e202c7e8f9062d202400f09b9df1
1 \input texinfo @c -*-texinfo-*-
2 @c %**start of header
3 @setfilename DUSIDatasheet.info
4 @settitle DUSIDatasheet
5 @c %**end of header
6 @c @title DUSI Datasheet
7 @c genindex description: characteristics and technical information
8 @center @titlefont{DUSI}
9 @center @image{imgs/dusi}
11 @ifnottex
12 @node Top
13 @top DUSIDatasheet
14 @end ifnottex
17 @menu
18 * Characteristics::
19 * Backlight:: 
20 * Battery::
21 * Parts::
22 * Components::
23 * DeviceData::
24 * Menu:: Menu
25 @end menu
27 @include DatasheetCharacteristics.texih
28 Weight: 315g
29 Weight without protective cover 144g
31 @node Backlight
32 @chapter Backlight
33 @center @titlefont{Backlight}
34 @multitable @columnfractions .6 .2 .2
35 @headitem  Parameter @tab Value @tab Unit
36 @item White Backlight Current @tab 8 @tab mA
37 @item Green Backlight Current @tab 4 @tab mA
38 @end multitable
40 Note:  On older DUSIv1 sometimes the backlight has issues because of the way the connector is placed.  Please email me for a free replacement if the backlight is not functioning.
42 @node Battery
43 @chapter Battery
44 @center @titlefont{Battery}
46 Battery charges from usb with a max of 100mA.
48 @multitable @columnfractions .6 .2 .2
49 @headitem  Parameter @tab Value @tab Unit
50 @item Battery Type @tab @code{3.6v lipo} @tab
51 @item Battery Capacity @tab 250 @tab mAH
52 @item Battery Charge Current @tab 100 @tab mA
53 @item Charge time @tab 4 @tab hours
54 @item Run time @tab >10@math{^1} @tab hours
55 @end multitable
57 1 decreases with age and backlight usage
59 @node Parts
60 @chapter Parts
61 @center @titlefont{Parts}
63 @itemize
64 @item 16key keypad
65 @item 132x64 lcd with green and white backlight
66 @item 70 series box with protective case (boxenclosures.com)
67 @item laser pointer
68 @item on/off switch
69 @item usb connector
70 @end itemize
72 @node Components
73 @chapter Components
75 @itemize
76 @item at90usb1287
77 @item sca3000-d01
78 @item ad7799
79 @item hmc1052
80 @item hmc1051z
81 @item irf7905 (x2)
82 @item max1811
83 @item fan2503S30
84 @item ra8816 lcd
85 @end itemize
87 Various capacitors resistors and connectors see schematic for details
89 @include DeviceDataIntro.texih
91 The DUSIv1 does not provide many accessors (it is stripped down from lack of flash memory)
93 @menu
94 * root:: root
95 * settings:: settings
96 * stats:: stats
97 * power:: power
98 * calc:: calc
99 * calibration:: calibration
100 * sensors:: sensors
101 * survey:: survey
102 @end menu
104 @include DeviceDataRoot.texih
106 @node settings
107 @section settings
109 @itemize @bullet
110 @include DeviceDataSettingsMag.texih
111 @item contrast -- the lcd contrast
112 @item reversevideo -- invert the lcd contents?
113 @item whitebacklight -- control the white backlight
114 @item greenbacklight -- control the green backlight
115 @end itemize
117 @include DeviceDataStats.texih
119 @node power
120 @section power
122 @itemize @bullet
123 @item battery
125 @itemize @bullet
126 @item voltage - the battery voltage
127 @item chargedvoltage - the voltage of the battery when it was last charged
128 @item dischargedvoltage - the voltage of the battery when it was last discharged
129 @item state - the current state of the battery
130 @end itemize
132 @item stillsleeptype - sleep type to use when the device is still
133 @item stillsleeptimeout - time the device must be still before sleeping
134 @item buttonidlesleeptype - sleep type to use when no buttons are pressed
135 @item buttonidletimeout - time the device must not have a button pressed before sleeping
136 @item wakeonmotion - if set to true, the device will wake on motion when it sleeps from being still.  It will not wake from motion from a button idle timeout.
137 @item lastsleeptype - the last type of sleep the device was in, used for debugging
138 @end itemize
140 Note: the device does not sleep when plugged in via USB.
142 The sleep types supported:
143 @itemize @bullet
144 @item none - sleep disabled
145 @item idle - sensors and processor stopped, device consumes about 15% of normal power.  Can wake up from the most different ways.
146 @item powersave - shutdown everything possible while still keeping the LCD and backlight on (if available)
147 @item powerdown - shutdown everything to lowest possible power consumption.  Uses about 0.5% of normal operating power.
148 @end itemize
150 Note: If wakeonmotion is set, because extra power is needed to be able to wake from motion, and the device sleeps from being still, the device will consume about 1.5% of normal operating power in powerdown mode rather than 0.5%.
152 @include DeviceDataCalc.texih
154 @include DeviceDataCalibration.texih
156 @include DeviceDataSensors.texih
158 @node survey
159 @section survey
160 The device can store various measurements
161 @itemize
162 @item stats - get for statistics about the measurements
163 @item measurements - get to dump all of the measurements
164 @item usebacksights - set to enable automatic backsights when surveying
165 @end itemize
168 @node Menu
169 @chapter Menu
171 The menu on the device is simple, press the key of the number letter or symbol which next to the word or icon you want to perform.  The main menu allows you to select a function for the device.  It is always possible to press 'D' repeatedly to eventually return to the Main Menu.  It is usually possible to press 'A' to read information about the current page.
173 @section Compass
174 The compass shows a 3d compass as well as other statistics.
176 @section Survey
178 The survey system allows you to take measurements of incline and azimuth using the laser.  These measurements may be recorded.  Typically there is enough storage for at least 500 shots.  It is also possible to enter attributes to go with each measurement (such as distance between survey points) but not required.
180 To make a measurement from the survey menu, hold '1' down and the laser will turn on, when you release it, a second later the laser will go off and the current reading is locked.
182 Once held, you can store the measurement with '2'.  If this should be a backsight for the last shot, press '3' to toggle to backsight mode.  If you want to enter distance LRUD, or other parameters, enter the attributes with '4' before storing.
184 Data required to store a shot, the minimum is 5 bytes for header, incline and azimuth, additional attributes add:
185 @itemize @bullet
186 @item 3 bytes  backsight incline and azimuth
187 @item 10 bytes - out of order stations penalty
188 @item 2 bytes - distance
189 @item 4 bytes - lrud
190 @end itemize
192 @multitable @columnfractions .2 .1 .1 .1 .1 .2
193 @headitem Name  To @tab Dist @tab Incline @tab Azimuth @tab LRUD @tab bytes
194 @item AFF-001 AFF-002 @tab - @tab +42.2 @tab 135.3 @tab @tab 15
195 @item AFF-002 AFF-003 @tab - @tab -26.7 @tab 167.4 @tab @tab 5
196 @item AFF-003 AFF-004 @tab 23.4 @tab +35.2 @tab 302.7 @tab @tab 7
197 @item AFF-003 AFF-005 @tab - @tab -42.1 @tab 253.9 @tab 1 1 2 3 @tab 19
198 @end multitable
201 The first measurement uses an extra 10 bytes because there is no measurement before it.  The fourth measurement uses 5 bytes normally, 4 more for lrud, and 10 more because the number is not sequential.
203 The measurements can be downloaded to a computer, or viewed on the device.
205 @section Pedometer
206 The pedometer uses a simple algorithm to detect steps by sensing verticle motion.  It counts steps with a given tolerance.
208 @section Gaussmeter
209 The gaussmeter allows you to measure magnetic fields in gauss.  There is support for absolute, relative and vector magnetometer modes.
211 @section Stats
212 View various statistics about the running program.
214 @section Calibration
215 Proper calibration is extremely important for accurate measurements.  The device can be re-calibrated at any time without any additional equipment.  The on-screen help system explains what each step of calibration does.
217 @section Settings
218 There are a few settings that can be modified on the device, there are far more settings that can be modified via the dataclient.
220 @section Plots
221 This mode allows you to plot the sensor data directly on the DUSI screen.  You may enter mathematical expressions using various sensor inputs as well.
223 @section Vector View
224 This mode simply displays vectors pointing in the direction of the accelerometer and magnetometer vectors.
226 @section Advanced Survey
227 This mode gives the user the ability to perform surveys in a linear state machine and gives error checking (FS/BS compare)
229 @section Calculator
230 This mode is simply a calculator.  It peforms basic expression parsing as well as reverse-polish notation.  Basic trig functions are supported.
232 @section Sphere Painter
233 This mode allows the user to draw arcs using the laser pointer, then view and rotate them in 3d on the screen.
235 @bye