diff options
Diffstat (limited to 'drivers/sensors/adns5050.c')
-rw-r--r-- | drivers/sensors/adns5050.c | 193 |
1 files changed, 193 insertions, 0 deletions
diff --git a/drivers/sensors/adns5050.c b/drivers/sensors/adns5050.c new file mode 100644 index 000000000..e7273977d --- /dev/null +++ b/drivers/sensors/adns5050.c | |||
@@ -0,0 +1,193 @@ | |||
1 | /* Copyright 2021 Colin Lam (Ploopy Corporation) | ||
2 | * Copyright 2020 Christopher Courtney, aka Drashna Jael're (@drashna) <drashna@live.com> | ||
3 | * Copyright 2019 Sunjun Kim | ||
4 | * Copyright 2019 Hiroyuki Okada | ||
5 | * | ||
6 | * This program is free software: you can redistribute it and/or modify | ||
7 | * it under the terms of the GNU General Public License as published by | ||
8 | * the Free Software Foundation, either version 2 of the License, or | ||
9 | * (at your option) any later version. | ||
10 | * | ||
11 | * This program is distributed in the hope that it will be useful, | ||
12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
14 | * GNU General Public License for more details. | ||
15 | * | ||
16 | * You should have received a copy of the GNU General Public License | ||
17 | * along with this program. If not, see <http://www.gnu.org/licenses/>. | ||
18 | */ | ||
19 | |||
20 | |||
21 | #include "adns5050.h" | ||
22 | #include "wait.h" | ||
23 | #include "debug.h" | ||
24 | #include "print.h" | ||
25 | #include "gpio.h" | ||
26 | |||
27 | #ifndef OPTIC_ROTATED | ||
28 | # define OPTIC_ROTATED false | ||
29 | #endif | ||
30 | |||
31 | // Definitions for the ADNS serial line. | ||
32 | #ifndef ADNS_SCLK_PIN | ||
33 | # define ADNS_SCLK_PIN B7 | ||
34 | #endif | ||
35 | |||
36 | #ifndef ADNS_SDIO_PIN | ||
37 | # define ADNS_SDIO_PIN C6 | ||
38 | #endif | ||
39 | |||
40 | #ifndef ADNS_CS_PIN | ||
41 | # define ADNS_CS_PIN B4 | ||
42 | #endif | ||
43 | |||
44 | #ifdef CONSOLE_ENABLE | ||
45 | void print_byte(uint8_t byte) { dprintf("%c%c%c%c%c%c%c%c|", (byte & 0x80 ? '1' : '0'), (byte & 0x40 ? '1' : '0'), (byte & 0x20 ? '1' : '0'), (byte & 0x10 ? '1' : '0'), (byte & 0x08 ? '1' : '0'), (byte & 0x04 ? '1' : '0'), (byte & 0x02 ? '1' : '0'), (byte & 0x01 ? '1' : '0')); } | ||
46 | #endif | ||
47 | |||
48 | // Initialize the ADNS serial pins. | ||
49 | void adns_init(void) { | ||
50 | setPinOutput(ADNS_SCLK_PIN); | ||
51 | setPinOutput(ADNS_SDIO_PIN); | ||
52 | setPinOutput(ADNS_CS_PIN); | ||
53 | } | ||
54 | |||
55 | // Perform a synchronization with the ADNS. | ||
56 | // Just as with the serial protocol, this is used by the slave to send a | ||
57 | // synchronization signal to the master. | ||
58 | void adns_sync(void) { | ||
59 | writePinLow(ADNS_CS_PIN); | ||
60 | wait_us(1); | ||
61 | writePinHigh(ADNS_CS_PIN); | ||
62 | } | ||
63 | |||
64 | void adns_cs_select(void) { | ||
65 | writePinLow(ADNS_CS_PIN); | ||
66 | } | ||
67 | |||
68 | void adns_cs_deselect(void) { | ||
69 | writePinHigh(ADNS_CS_PIN); | ||
70 | } | ||
71 | |||
72 | uint8_t adns_serial_read(void) { | ||
73 | setPinInput(ADNS_SDIO_PIN); | ||
74 | uint8_t byte = 0; | ||
75 | |||
76 | for (uint8_t i = 0; i < 8; ++i) { | ||
77 | writePinLow(ADNS_SCLK_PIN); | ||
78 | wait_us(1); | ||
79 | |||
80 | byte = (byte << 1) | readPin(ADNS_SDIO_PIN); | ||
81 | |||
82 | writePinHigh(ADNS_SCLK_PIN); | ||
83 | wait_us(1); | ||
84 | } | ||
85 | |||
86 | return byte; | ||
87 | } | ||
88 | |||
89 | void adns_serial_write(uint8_t data) { | ||
90 | setPinOutput(ADNS_SDIO_PIN); | ||
91 | |||
92 | for (int8_t b = 7; b >= 0; b--) { | ||
93 | writePinLow(ADNS_SCLK_PIN); | ||
94 | |||
95 | if (data & (1 << b)) | ||
96 | writePinHigh(ADNS_SDIO_PIN); | ||
97 | else | ||
98 | writePinLow(ADNS_SDIO_PIN); | ||
99 | |||
100 | wait_us(2); | ||
101 | |||
102 | writePinHigh(ADNS_SCLK_PIN); | ||
103 | } | ||
104 | |||
105 | // tSWR. See page 15 of the ADNS spec sheet. | ||
106 | // Technically, this is only necessary if the next operation is an SDIO | ||
107 | // read. This is not guaranteed to be the case, but we're being lazy. | ||
108 | wait_us(4); | ||
109 | |||
110 | // Note that tSWW is never necessary. All write operations require at | ||
111 | // least 32us, which exceeds tSWW, so there's never a need to wait for it. | ||
112 | } | ||
113 | |||
114 | // Read a byte of data from a register on the ADNS. | ||
115 | // Don't forget to use the register map (as defined in the header file). | ||
116 | uint8_t adns_read_reg(uint8_t reg_addr) { | ||
117 | adns_cs_select(); | ||
118 | |||
119 | adns_serial_write(reg_addr); | ||
120 | |||
121 | // We don't need a minimum tSRAD here. That's because a 4ms wait time is | ||
122 | // already included in adns_serial_write(), so we're good. | ||
123 | // See page 10 and 15 of the ADNS spec sheet. | ||
124 | //wait_us(4); | ||
125 | |||
126 | uint8_t byte = adns_serial_read(); | ||
127 | |||
128 | // tSRW & tSRR. See page 15 of the ADNS spec sheet. | ||
129 | // Technically, this is only necessary if the next operation is an SDIO | ||
130 | // read or write. This is not guaranteed to be the case. | ||
131 | // Honestly, this wait could probably be removed. | ||
132 | wait_us(1); | ||
133 | |||
134 | adns_cs_deselect(); | ||
135 | |||
136 | return byte; | ||
137 | } | ||
138 | |||
139 | void adns_write_reg(uint8_t reg_addr, uint8_t data) { | ||
140 | adns_cs_select(); | ||
141 | adns_serial_write( 0b10000000 | reg_addr ); | ||
142 | adns_serial_write(data); | ||
143 | adns_cs_deselect(); | ||
144 | } | ||
145 | |||
146 | report_adns_t adns_read_burst(void) { | ||
147 | adns_cs_select(); | ||
148 | |||
149 | report_adns_t data; | ||
150 | data.dx = 0; | ||
151 | data.dy = 0; | ||
152 | |||
153 | adns_serial_write(REG_MOTION_BURST); | ||
154 | |||
155 | // We don't need a minimum tSRAD here. That's because a 4ms wait time is | ||
156 | // already included in adns_serial_write(), so we're good. | ||
157 | // See page 10 and 15 of the ADNS spec sheet. | ||
158 | //wait_us(4); | ||
159 | |||
160 | uint8_t x = adns_serial_read(); | ||
161 | uint8_t y = adns_serial_read(); | ||
162 | |||
163 | // Burst mode returns a bunch of other shit that we don't really need. | ||
164 | // Setting CS to high ends burst mode early. | ||
165 | adns_cs_deselect(); | ||
166 | |||
167 | data.dx = convert_twoscomp(x); | ||
168 | data.dy = convert_twoscomp(y); | ||
169 | |||
170 | return data; | ||
171 | } | ||
172 | |||
173 | // Convert a two's complement byte from an unsigned data type into a signed | ||
174 | // data type. | ||
175 | int8_t convert_twoscomp(uint8_t data) { | ||
176 | if ((data & 0x80) == 0x80) | ||
177 | return -128 + (data & 0x7F); | ||
178 | else | ||
179 | return data; | ||
180 | } | ||
181 | |||
182 | // Don't forget to use the definitions for CPI in the header file. | ||
183 | void adns_set_cpi(uint8_t cpi) { | ||
184 | adns_write_reg(REG_MOUSE_CONTROL2, cpi); | ||
185 | } | ||
186 | |||
187 | bool adns_check_signature(void) { | ||
188 | uint8_t pid = adns_read_reg(REG_PRODUCT_ID); | ||
189 | uint8_t rid = adns_read_reg(REG_REVISION_ID); | ||
190 | uint8_t pid2 = adns_read_reg(REG_PRODUCT_ID2); | ||
191 | |||
192 | return (pid == 0x12 && rid == 0x01 && pid2 == 0x26); | ||
193 | } | ||