Rev 248 | Rev 251 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
242 | killagreg | 1 | /*#######################################################################################*/ |
2 | /* !!! THIS IS NOT FREE SOFTWARE !!! */ |
||
3 | /*#######################################################################################*/ |
||
4 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
5 | // + Copyright (c) 2010 Ingo Busker, Holger Buss |
||
6 | // + Nur für den privaten Gebrauch / NON-COMMERCIAL USE ONLY |
||
7 | // + FOR NON COMMERCIAL USE ONLY |
||
8 | // + www.MikroKopter.com |
||
9 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
10 | // + Es gilt für das gesamte Projekt (Hardware, Software, Binärfiles, Sourcecode und Dokumentation), |
||
11 | // + dass eine Nutzung (auch auszugsweise) nur für den privaten (nicht-kommerziellen) Gebrauch zulässig ist. |
||
12 | // + Sollten direkte oder indirekte kommerzielle Absichten verfolgt werden, ist mit uns (info@mikrokopter.de) Kontakt |
||
13 | // + bzgl. der Nutzungsbedingungen aufzunehmen. |
||
14 | // + Eine kommerzielle Nutzung ist z.B.Verkauf von MikroKoptern, Bestückung und Verkauf von Platinen oder Bausätzen, |
||
15 | // + Verkauf von Luftbildaufnahmen, usw. |
||
16 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
17 | // + Werden Teile des Quellcodes (mit oder ohne Modifikation) weiterverwendet oder veröffentlicht, |
||
18 | // + unterliegen sie auch diesen Nutzungsbedingungen und diese Nutzungsbedingungen incl. Copyright müssen dann beiliegen |
||
19 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
20 | // + Sollte die Software (auch auszugesweise) oder sonstige Informationen des MikroKopter-Projekts |
||
21 | // + auf anderen Webseiten oder sonstigen Medien veröffentlicht werden, muss unsere Webseite "http://www.mikrokopter.de" |
||
22 | // + eindeutig als Ursprung verlinkt werden |
||
23 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
24 | // + Keine Gewähr auf Fehlerfreiheit, Vollständigkeit oder Funktion |
||
25 | // + Benutzung auf eigene Gefahr |
||
26 | // + Wir übernehmen keinerlei Haftung für direkte oder indirekte Personen- oder Sachschäden |
||
27 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
28 | // + Die Portierung oder Nutzung der Software (oder Teile davon) auf andere Systeme (ausser der Hardware von www.mikrokopter.de) ist nur |
||
29 | // + mit unserer Zustimmung zulässig |
||
30 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
31 | // + Die Funktion printf_P() unterliegt ihrer eigenen Lizenz und ist hiervon nicht betroffen |
||
32 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
33 | // + Redistributions of source code (with or without modifications) must retain the above copyright notice, |
||
34 | // + this list of conditions and the following disclaimer. |
||
35 | // + * Neither the name of the copyright holders nor the names of contributors may be used to endorse or promote products derived |
||
36 | // + from this software without specific prior written permission. |
||
37 | // + * The use of this project (hardware, software, binary files, sources and documentation) is only permitted |
||
38 | // + for non-commercial use (directly or indirectly) |
||
39 | // + Commercial use (for excample: selling of MikroKopters, selling of PCBs, assembly, ...) is only permitted |
||
40 | // + with our written permission |
||
41 | // + * If sources or documentations are redistributet on other webpages, out webpage (http://www.MikroKopter.de) must be |
||
42 | // + clearly linked as origin |
||
43 | // + * porting the sources to other systems or using the software on other systems (except hardware from www.mikrokopter.de) is not allowed |
||
44 | // |
||
45 | // + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
||
46 | // + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
||
47 | // + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
||
48 | // + ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE |
||
49 | // + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
||
50 | // + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
||
51 | // + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
||
52 | // + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
||
53 | // + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
||
54 | // + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
||
55 | // + POSSIBILITY OF SUCH DAMAGE. |
||
56 | // ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
||
57 | #include <string.h> |
||
58 | #include "91x_lib.h" |
||
59 | #include "hmc5843.h" |
||
60 | #include "i2c.h" |
||
61 | #include "timer1.h" |
||
62 | #include "led.h" |
||
63 | #include "spi_slave.h" |
||
64 | #include "uart1.h" |
||
65 | #include "compass.h" |
||
66 | |||
67 | #define HMC5843_SLAVE_ADDRESS 0x3C // i2C slave address |
||
68 | |||
69 | u8 HMC5843_Present = 0; |
||
70 | |||
71 | #define REGISTER_CRA 0 |
||
72 | #define REGISTER_CRB 1 |
||
73 | #define REGISTER_MODE 2 |
||
74 | #define REGISTER_DATAX_MSB 3 |
||
75 | #define REGISTER_DATAX_LSB 4 |
||
76 | #define REGISTER_DATAY_MSB 5 |
||
77 | #define REGISTER_DATAY_LSB 6 |
||
78 | #define REGISTER_DATAZ_MSB 7 |
||
79 | #define REGISTER_DATAZ_LSB 8 |
||
80 | #define REGISTER_STATUS 9 |
||
81 | #define REGISTER_IDA 10 |
||
82 | #define REGISTER_IDB 11 |
||
83 | #define REGISTER_IDC 12 |
||
84 | |||
85 | |||
86 | #define HMC5843_IDA 0x48 |
||
87 | #define HMC5843_IDB 0x34 |
||
88 | #define HMC5843_IDC 0x33 |
||
89 | |||
90 | // bit mask for rate |
||
91 | #define HMC5843_CRA_RATE_MASK 0x1C |
||
92 | #define HMC5843_CRA_RATE_0_5HZ 0x00 |
||
93 | #define HMC5843_CRA_RATE_1HZ 0x04 |
||
94 | #define HMC5843_CRA_RATE_2HZ 0x08 |
||
95 | #define HMC5843_CRA_RATE_5HZ 0x0C |
||
96 | #define HMC5843_CRA_RATE_10HZ 0x10 //default |
||
97 | #define HMC5843_CRA_RATE_20HZ 0x14 |
||
98 | #define HMC5843_CRA_RATE_50HZ 0x18 |
||
99 | |||
100 | // bit mask for mode |
||
101 | #define HMC5843_CRA_MODE_MASK 0x03 |
||
102 | #define HMC5843_CRA_MODE_NORMAL 0x00 //default |
||
103 | #define HMC5843_CRA_MODE_POSBIAS 0x01 |
||
104 | #define HMC5843_CRA_MODE_NEGBIAS 0x02 |
||
105 | #define HMC5843_CRA_MODE_SELFTEST 0x03 |
||
106 | |||
107 | // bit mask for gain |
||
108 | #define HMC5843_CRB_GAIN_MASK 0xE0 |
||
109 | #define HMC5843_CRB_GAIN_07GA 0x00 |
||
110 | #define HMC5843_CRB_GAIN_10GA 0x20 //default |
||
111 | #define HMC5843_CRB_GAIN_15GA 0x40 |
||
112 | #define HMC5843_CRB_GAIN_20GA 0x60 |
||
113 | #define HMC5843_CRB_GAIN_32GA 0x80 |
||
114 | #define HMC5843_CRB_GAIN_38GA 0xA0 |
||
115 | #define HMC5843_CRB_GAIN_45GA 0xC0 |
||
116 | #define HMC5843_CRB_GAIN_65GA 0xE0 |
||
117 | |||
118 | // bit mask for measurement mode |
||
119 | #define HMC5843_MODE_MASK 0xFF |
||
120 | #define HMC5843_MODE_CONTINUOUS 0x00 |
||
121 | #define HMC5843_MODE_SINGLE 0x01 // default |
||
122 | #define HMC5843_MODE_IDLE 0x02 |
||
123 | #define HMC5843_MODE_SLEEP 0x03 |
||
124 | |||
125 | typedef struct |
||
126 | { |
||
127 | u8 A; |
||
128 | u8 B; |
||
129 | u8 C; |
||
130 | } __attribute__((packed)) HMC5843_Identification_t; |
||
131 | |||
132 | volatile HMC5843_Identification_t HMC5843_Identification; |
||
133 | |||
134 | |||
135 | |||
136 | // ---------- call back handlers ----------------------------------------- |
||
137 | |||
138 | // rx data handler for id info request |
||
139 | void HMC5843_UpdateIdentification(u8* pRxBuffer, u8 RxBufferSize) |
||
140 | { // if number of byte are matching |
||
141 | if(RxBufferSize == sizeof(HMC5843_Identification) ) |
||
142 | { |
||
143 | memcpy((u8 *)&HMC5843_Identification, pRxBuffer, sizeof(HMC5843_Identification)); |
||
144 | } |
||
145 | } |
||
146 | |||
147 | // rx data handler for mag vector request |
||
148 | void HMC5843_UpdateMagVector(u8* pRxBuffer, u8 RxBufferSize) |
||
149 | { // if number of byte are matching |
||
150 | if(RxBufferSize == sizeof(MagVector) ) |
||
243 | killagreg | 151 | { // byte order from big to little endian |
242 | killagreg | 152 | MagVector.X = pRxBuffer[0]<<8; |
153 | MagVector.X+= pRxBuffer[1]; |
||
154 | MagVector.Y = pRxBuffer[2]<<8; |
||
155 | MagVector.Y+= pRxBuffer[3]; |
||
156 | MagVector.Z = pRxBuffer[4]<<8; |
||
157 | MagVector.Z+= pRxBuffer[5]; |
||
158 | } |
||
159 | // tbd. calculate heading from mag vector and attitude |
||
160 | CompassHeading = 50; // tbd. |
||
161 | } |
||
162 | |||
163 | |||
164 | // ---------------------------------------------------------------------------------------- |
||
165 | |||
166 | void HMC5843_GetIdentification(void) |
||
167 | { |
||
248 | killagreg | 168 | if(I2C_LockBuffer(100)) |
242 | killagreg | 169 | { |
248 | killagreg | 170 | u16 TxBytes = 0; |
171 | HMC5843_Identification.A = 0xFF; |
||
172 | HMC5843_Identification.B = 0xFF; |
||
173 | HMC5843_Identification.C = 0xFF; |
||
174 | I2C_Buffer[TxBytes++] = REGISTER_IDA; |
||
242 | killagreg | 175 | // initiate transmission |
248 | killagreg | 176 | if(I2C_Transmission(HMC5843_SLAVE_ADDRESS, TxBytes, &HMC5843_UpdateIdentification, sizeof(HMC5843_Identification))) |
177 | { |
||
178 | I2C_WaitForEndOfTransmission(100); |
||
179 | } |
||
242 | killagreg | 180 | } |
181 | } |
||
182 | |||
183 | // ---------------------------------------------------------------------------------------- |
||
184 | u8 HMC5843_SetConfiguration(u8 cra, u8 crb, u8 mode) |
||
185 | { |
||
248 | killagreg | 186 | u8 retval = 0; |
187 | if(I2C_LockBuffer(100)) |
||
242 | killagreg | 188 | { |
248 | killagreg | 189 | u16 TxBytes = 0; |
190 | I2C_Buffer[TxBytes++] = REGISTER_CRA; |
||
191 | I2C_Buffer[TxBytes++] = cra; |
||
192 | I2C_Buffer[TxBytes++] = crb; |
||
193 | I2C_Buffer[TxBytes++] = mode; |
||
194 | // initiate transmission |
||
195 | if(I2C_Transmission(HMC5843_SLAVE_ADDRESS, TxBytes, NULL, 0)) |
||
196 | { |
||
197 | retval = I2C_WaitForEndOfTransmission(50); |
||
198 | } |
||
242 | killagreg | 199 | } |
248 | killagreg | 200 | return(retval); |
242 | killagreg | 201 | } |
202 | |||
203 | //---------------------------------------------------------------- |
||
243 | killagreg | 204 | void HMC5843_GetMagVector(void) |
205 | { |
||
248 | killagreg | 206 | if(I2C_LockBuffer(100)) |
243 | killagreg | 207 | { |
248 | killagreg | 208 | u16 TxBytes = 0; |
243 | killagreg | 209 | // set register pointer |
248 | killagreg | 210 | I2C_Buffer[TxBytes++] = REGISTER_DATAX_MSB; |
243 | killagreg | 211 | // initiate transmission |
248 | killagreg | 212 | I2C_Transmission(HMC5843_SLAVE_ADDRESS, TxBytes, &HMC5843_UpdateMagVector, sizeof(MagVector)); |
243 | killagreg | 213 | } |
214 | } |
||
215 | |||
216 | void HMC5843_UpdateCompass(void) |
||
217 | { |
||
218 | static u32 TimerCompassUpdate = 0; |
||
219 | |||
220 | if( (I2C_State == I2C_STATE_OFF) || !HMC5843_Present ) return; |
||
221 | |||
222 | if(CheckDelay(TimerCompassUpdate)) |
||
223 | { |
||
224 | // check for incomming compass calibration request |
||
225 | // update CalByte from spi input queue |
||
226 | /*fifo_get(&CompassCalcStateFiFo, (u8 *)&(MK3MAG_WriteCal.CalByte)); |
||
227 | // send new calstate |
||
228 | if(MK3MAG_ReadCal.CalByte != MK3MAG_WriteCal.CalByte) |
||
229 | { |
||
230 | do the calibration here |
||
231 | } |
||
232 | else // request current heading */ |
||
233 | { |
||
234 | HMC5843_GetMagVector(); |
||
235 | } |
||
236 | TimerCompassUpdate = SetDelay(20); // every 20 ms are 50 Hz |
||
237 | } |
||
238 | } |
||
239 | |||
240 | u8 HMC5843_SelfTest(void) |
||
241 | { |
||
242 | u32 time; |
||
243 | s32 XMin = 0, XMax = 0, YMin = 0, YMax = 0, ZMin = 0, ZMax = 0; |
||
244 | s32 scale, scale_min, scale_max; |
||
245 | u8 i = 0; |
||
246 | |||
247 | // activate positive bias field of 0.55 gauss |
||
248 | HMC5843_SetConfiguration(HMC5843_CRA_RATE_50HZ|HMC5843_CRA_MODE_POSBIAS, HMC5843_CRB_GAIN_10GA, HMC5843_MODE_CONTINUOUS); |
||
249 | // averaging |
||
250 | for(i = 0; i<20; i++) |
||
251 | { |
||
252 | HMC5843_GetMagVector(); |
||
253 | time = SetDelay(20); |
||
254 | while(!CheckDelay(time)); |
||
255 | XMax += MagVector.X; |
||
256 | YMax += MagVector.Y; |
||
257 | ZMax += MagVector.Z; |
||
258 | } |
||
259 | // activate negative bias field of 0.55 gauss |
||
260 | HMC5843_SetConfiguration(HMC5843_CRA_RATE_50HZ|HMC5843_CRA_MODE_NEGBIAS, HMC5843_CRB_GAIN_10GA, HMC5843_MODE_CONTINUOUS); |
||
261 | while(!CheckDelay(time)); |
||
262 | // averaging |
||
263 | for(i = 0; i < 20; i++) |
||
264 | { |
||
265 | HMC5843_GetMagVector(); |
||
266 | time = SetDelay(20); |
||
267 | while(!CheckDelay(time)); |
||
268 | XMin += MagVector.X; |
||
269 | YMin += MagVector.Y; |
||
270 | ZMin += MagVector.Z; |
||
271 | } |
||
272 | // setup final configuration |
||
273 | HMC5843_SetConfiguration(HMC5843_CRA_RATE_50HZ|HMC5843_CRA_MODE_NORMAL, HMC5843_CRB_GAIN_10GA, HMC5843_MODE_CONTINUOUS); |
||
274 | // prepare scale limits |
||
275 | scale = 715; // 1300 counts/Gauss * 0.55 Gauss = 715 counts |
||
248 | killagreg | 276 | scale_min = (scale * 90)/100; |
243 | killagreg | 277 | scale_max = (scale * 110)/100; |
278 | // check scale for all axes |
||
279 | scale = (XMax - XMin)/40; |
||
250 | ingob | 280 | if((scale > scale_max) || (scale < scale_min)) return 0; |
243 | killagreg | 281 | scale = (YMax + YMin)/40; |
250 | ingob | 282 | if((scale > scale_max) || (scale < scale_min)) return 0; |
243 | killagreg | 283 | scale = (ZMax + ZMin)/40; |
250 | ingob | 284 | if((scale > scale_max) || (scale < scale_min)) return 0; |
243 | killagreg | 285 | return 1; |
286 | } |
||
287 | |||
288 | |||
289 | //---------------------------------------------------------------- |
||
242 | killagreg | 290 | u8 HMC5843_Init(void) |
291 | { |
||
292 | u8 msg[64]; |
||
293 | u8 repeat; |
||
294 | |||
295 | HMC5843_Present = 0; |
||
296 | |||
297 | HMC5843_Identification.A = 0xFF; |
||
298 | HMC5843_Identification.B = 0xFF; |
||
299 | HMC5843_Identification.C = 0xFF; |
||
300 | |||
301 | // polling of identification |
||
302 | repeat = 0; |
||
303 | do |
||
304 | { |
||
305 | HMC5843_GetIdentification(); |
||
248 | killagreg | 306 | if (HMC5843_Identification.A != 0xFF) break; // break loop on success |
242 | killagreg | 307 | UART1_PutString("."); |
308 | repeat++; |
||
309 | }while ((HMC5843_Identification.A == 0xFF) && (repeat < 12)); // 12*250ms=3s |
||
310 | // if we got it |
||
311 | if(HMC5843_Identification.A != 0xFF) |
||
312 | { |
||
243 | killagreg | 313 | sprintf(msg, " HMC5843 ID %d/%d/%d", HMC5843_Identification.A, HMC5843_Identification.B, HMC5843_Identification.C); |
242 | killagreg | 314 | UART1_PutString(msg); |
315 | |||
316 | if ( (HMC5843_Identification.A == HMC5843_IDA) |
||
317 | && (HMC5843_Identification.B == HMC5843_IDB) |
||
318 | && (HMC5843_Identification.C == HMC5843_IDC)) |
||
319 | { |
||
243 | killagreg | 320 | //HMC5843_SetConfiguration(HMC5843_CRA_RATE_50HZ|HMC5843_CRA_MODE_NORMAL, HMC5843_CRB_GAIN_10GA, HMC5843_MODE_CONTINUOUS); |
321 | if(!HMC5843_SelfTest()) |
||
322 | { |
||
323 | UART1_PutString("\n\r HMC5843 selftest failed!"); |
||
324 | LED_RED_ON; |
||
325 | } |
||
326 | else HMC5843_Present = 1; |
||
242 | killagreg | 327 | } |
328 | else |
||
329 | { |
||
330 | UART1_PutString("\n\r HMC5843 not compatible!"); |
||
331 | LED_RED_ON; |
||
332 | } |
||
333 | } |
||
334 | return(HMC5843_Present); |
||
335 | } |
||
336 |