5d44bffdae8982bead6f95152be2d4ddd0acf111
[fw/altos] / src / drivers / ao_mma655x.c
1 /*
2  * Copyright © 2012 Keith Packard <keithp@keithp.com>
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; either version 2 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License along
15  * with this program; if not, write to the Free Software Foundation, Inc.,
16  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
17  */
18
19 #include <ao.h>
20 #include <ao_mma655x.h>
21
22 #if HAS_MMA655X
23
24 #define DEBUG           0
25 #define DEBUG_LOW       1
26 #define DEBUG_HIGH      2
27 #if 1
28 #define PRINTD(l, ...) do { if (DEBUG & (l)) { printf ("\r%5u %s: ", ao_tick_count, __func__); printf(__VA_ARGS__); flush(); } } while(0)
29 #else
30 #define PRINTD(l,...) 
31 #endif
32
33 static void
34 ao_mma655x_start(void) {
35         ao_spi_get_bit(AO_MMA655X_CS_PORT,
36                        AO_MMA655X_CS_PIN,
37                        AO_MMA655X_CS,
38                        AO_MMA655X_SPI_INDEX,
39                        AO_SPI_SPEED_FAST);
40 }
41
42 static void
43 ao_mma655x_stop(void) {
44         ao_spi_put_bit(AO_MMA655X_CS_PORT,
45                        AO_MMA655X_CS_PIN,
46                        AO_MMA655X_CS,
47                        AO_MMA655X_SPI_INDEX);
48 }
49
50 static void
51 ao_mma655x_restart(void) {
52         uint8_t i;
53         ao_gpio_set(AO_MMA655X_CS_PORT, AO_MMA655X_CS_PIN, AO_MMA655X_CS, 1);
54
55         /* Emperical testing on STM32L151 at 32MHz for this delay amount */
56         for (i = 0; i < 10; i++)
57                 ao_arch_nop();
58         ao_gpio_set(AO_MMA655X_CS_PORT, AO_MMA655X_CS_PIN, AO_MMA655X_CS, 0);
59 }
60
61 static uint8_t
62 ao_parity(uint8_t v)
63 {
64         uint8_t p;
65         /* down to four bits */
66         p = (v ^ (v >> 4)) & 0xf;
67
68         /* Cute lookup hack -- 0x6996 encodes the sixteen
69          * even parity values in order.
70          */
71         p = (~0x6996 >> p) & 1;
72         return p;
73 }
74
75 #if 0
76 static void
77 ao_mma655x_cmd(uint8_t d[2])
78 {
79         ao_mma655x_start();
80         PRINTD(DEBUG_LOW, "\tSEND %02x %02x\n", d[0], d[1]);
81         ao_spi_duplex(d, d, 2, AO_MMA655X_SPI_INDEX);
82         PRINTD(DEBUG_LOW, "\t\tRECV %02x %02x\n", d[0], d[1]);
83         ao_mma655x_stop();
84 }
85 #endif
86
87 static uint8_t
88 ao_mma655x_reg_read(uint8_t addr)
89 {
90         uint8_t d[2];
91         ao_mma655x_start();
92         d[0] = addr | (ao_parity(addr) << 7);
93         d[1] = 0;
94         ao_spi_send(&d, 2, AO_MMA655X_SPI_INDEX);
95         ao_mma655x_restart();
96
97         /* Send a dummy read of 00 to clock out the SPI data */
98         d[0] = 0x80;
99         d[1] = 0x00;
100         ao_spi_duplex(&d, &d, 2, AO_MMA655X_SPI_INDEX);
101         ao_mma655x_stop();
102         PRINTD(DEBUG_LOW, "read %x = %x %x\n", addr, d[0], d[1]);
103         return d[1];
104 }
105
106 static void
107 ao_mma655x_reg_write(uint8_t addr, uint8_t value)
108 {
109         uint8_t d[2];
110
111         PRINTD(DEBUG_LOW, "write %x %x\n", addr, value);
112         addr |= (1 << 6);       /* write mode */
113         d[0] = addr | (ao_parity(addr^value) << 7);
114         d[1] = value;
115         ao_mma655x_start();
116         ao_spi_send(d, 2, AO_MMA655X_SPI_INDEX);
117         ao_mma655x_stop();
118
119         addr &= ~(1 << 6);
120 }
121
122 static uint16_t
123 ao_mma655x_value(void)
124 {
125         uint8_t         d[2];
126         uint16_t        v;
127
128         d[0] = ((0 << 6) |      /* Axis selection (X) */
129                 (1 << 5) |      /* Acceleration operation */
130                 (1 << 4));      /* Raw data */
131         d[1] = ((1 << 3) |      /* must be one */
132                 (1 << 2) |      /* Unsigned data */
133                 (0 << 1) |      /* Arm disabled */
134                 (1 << 0));      /* Odd parity */
135         ao_mma655x_start();
136         PRINTD(DEBUG_LOW, "value SEND %02x %02x\n", d[0], d[1]);
137         ao_spi_send(d, 2, AO_MMA655X_SPI_INDEX);
138         ao_mma655x_restart();
139         d[0] = 0x80;
140         d[1] = 0x00;
141         ao_spi_duplex(d, d, 2, AO_MMA655X_SPI_INDEX);
142         ao_mma655x_stop();
143         PRINTD(DEBUG_LOW, "value RECV %02x %02x\n", d[0], d[1]);
144
145         v = (uint16_t) d[1] << 2;
146         v |= d[0] >> 6;
147         v |= (uint16_t) (d[0] & 3) << 10;
148         return v;
149 }
150
151 static void
152 ao_mma655x_reset(void) {
153         PRINTD(DEBUG_HIGH, "reset\n");
154         ao_mma655x_reg_write(AO_MMA655X_DEVCTL,
155                              (0 << AO_MMA655X_DEVCTL_RES_1) |
156                              (0 << AO_MMA655X_DEVCTL_RES_0));
157         ao_mma655x_reg_write(AO_MMA655X_DEVCTL,
158                              (1 << AO_MMA655X_DEVCTL_RES_1) |
159                              (1 << AO_MMA655X_DEVCTL_RES_0));
160         ao_mma655x_reg_write(AO_MMA655X_DEVCTL,
161                              (0 << AO_MMA655X_DEVCTL_RES_1) |
162                              (1 << AO_MMA655X_DEVCTL_RES_0));
163 }
164
165 #define DEVCFG_VALUE    (\
166         (1 << AO_MMA655X_DEVCFG_OC) |           /* Disable offset cancelation */ \
167         (1 << AO_MMA655X_DEVCFG_SD) |           /* Receive unsigned data */ \
168         (0 << AO_MMA655X_DEVCFG_OFMON) |        /* Disable offset monitor */ \
169         (AO_MMA655X_DEVCFG_A_CFG_DISABLE << AO_MMA655X_DEVCFG_A_CFG))
170
171 #define AXISCFG_VALUE   (\
172                 (0 << AO_MMA655X_AXISCFG_LPF))  /* 100Hz 4-pole filter */
173
174
175 #define AO_ST_TRIES     10
176 #define AO_ST_DELAY     AO_MS_TO_TICKS(100)
177
178 static void
179 ao_mma655x_setup(void)
180 {
181         uint16_t        a, a_st;
182         int16_t         st_change;
183         int             tries;
184         uint8_t         devstat;
185 #if 0
186         uint8_t s0, s1, s2, s3;
187         uint32_t        lot;
188 #endif
189
190         for (tries = 0; tries < AO_ST_TRIES; tries++) {
191                 ao_delay(AO_MS_TO_TICKS(10));
192                 ao_mma655x_reset();
193                 ao_delay(AO_MS_TO_TICKS(10));
194
195                 devstat = ao_mma655x_reg_read(AO_MMA655X_DEVSTAT);
196                 PRINTD(DEBUG_HIGH, "devstat %x\n", devstat);
197
198                 if (!(devstat & (1 << AO_MMA655X_DEVSTAT_DEVRES)))
199                         continue;
200
201                 /* Configure R/W register values.
202                  * Most of them relate to the arming feature, which
203                  * we don't use, so the only registers we need to
204                  * write are DEVCFG and AXISCFG
205                  */
206
207                 ao_mma655x_reg_write(AO_MMA655X_DEVCFG,
208                                      DEVCFG_VALUE | (0 << AO_MMA655X_DEVCFG_ENDINIT));
209
210                 /* Test X axis
211                  */
212         
213                 ao_mma655x_reg_write(AO_MMA655X_AXISCFG,
214                                      AXISCFG_VALUE |
215                                      (1 << AO_MMA655X_AXISCFG_ST));
216                 ao_delay(AO_MS_TO_TICKS(10));
217
218                 a_st = ao_mma655x_value();
219
220                 ao_mma655x_reg_write(AO_MMA655X_AXISCFG,
221                                      AXISCFG_VALUE |
222                                      (0 << AO_MMA655X_AXISCFG_ST));
223
224                 ao_delay(AO_MS_TO_TICKS(10));
225
226                 a = ao_mma655x_value();
227
228                 st_change = a_st - a;
229
230                 PRINTD(DEBUG_HIGH, "self test %d normal %d change %d\n", a_st, a, st_change);
231
232                 if (AO_ST_MIN <= st_change && st_change <= AO_ST_MAX)
233                         break;
234                 ao_delay(AO_ST_DELAY);
235         }
236         if (tries == AO_ST_TRIES)
237                 ao_sensor_errors = 1;
238
239         ao_mma655x_reg_write(AO_MMA655X_DEVCFG,
240                              DEVCFG_VALUE | (1 << AO_MMA655X_DEVCFG_ENDINIT));
241 #if 0
242         s0 = ao_mma655x_reg_read(AO_MMA655X_SN0);
243         s1 = ao_mma655x_reg_read(AO_MMA655X_SN1);
244         s2 = ao_mma655x_reg_read(AO_MMA655X_SN2);
245         s3 = ao_mma655x_reg_read(AO_MMA655X_SN3);
246         lot = ((uint32_t) s3 << 24) | ((uint32_t) s2 << 16) |
247                 ((uint32_t) s1 << 8) | ((uint32_t) s0);
248         serial = lot & 0x1fff;
249         lot >>= 12;
250         pn = ao_mma655x_reg_read(AO_MMA655X_PN);
251 #endif
252 }
253
254 uint16_t        ao_mma655x_current;
255
256 static void
257 ao_mma655x_dump(void)
258 {
259         printf ("MMA655X value %d\n", ao_mma655x_current);
260 }
261
262 __code struct ao_cmds ao_mma655x_cmds[] = {
263         { ao_mma655x_dump,      "A\0Display MMA655X data" },
264         { 0, NULL },
265 };
266
267 static void
268 ao_mma655x(void)
269 {
270         ao_mma655x_setup();
271         for (;;) {
272                 ao_mma655x_current = ao_mma655x_value();
273                 ao_arch_critical(
274                         AO_DATA_PRESENT(AO_DATA_MMA655X);
275                         AO_DATA_WAIT();
276                         );
277         }
278 }
279
280 static __xdata struct ao_task ao_mma655x_task;
281
282 void
283 ao_mma655x_init(void)
284 {
285         ao_cmd_register(&ao_mma655x_cmds[0]);
286         ao_spi_init_cs(AO_MMA655X_CS_PORT, (1 << AO_MMA655X_CS_PIN));
287
288         ao_add_task(&ao_mma655x_task, ao_mma655x, "mma655x");
289 }
290
291 #endif