1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
/*
The MIT License (MIT)
Copyright (c) 2016 British Broadcasting Corporation.
This software is provided by Lancaster University by arrangement with the BBC.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
*/
#include "MicroBitConfig.h"
#include "MicroBitI2C.h"
#include "ErrorNo.h"
#include "twi_master.h"
#include "nrf_delay.h"
/**
* Constructor.
*
* Create an instance of MicroBitI2C for I2C communication.
*
* @param sda the Pin to be used for SDA
*
* @param scl the Pin to be used for SCL
*
* @code
* MicroBitI2C i2c(I2C_SDA0, I2C_SCL0);
* @endcode
*
* @note This class presents a wrapped mbed call to capture failed I2C operations caused by a known silicon bug in the nrf51822.
* Attempts to automatically reset and restart the I2C hardware if this case is detected.
* \par
* For reference see PAN56 in:
* \par
* https://www.nordicsemi.com/eng/nordic/Products/nRF51822/PAN-nRF51822/24634
* \par
* v2.0 through to v2.4
*/
MicroBitI2C::MicroBitI2C(PinName sda, PinName scl) : I2C(sda,scl)
{
this->retries = 0;
}
/**
* Performs a complete read transaction. The bottom bit of the address is forced to 1 to indicate a read.
*
* @param address 8-bit I2C slave address [ addr | 1 ]
*
* @param data A pointer to a byte buffer used for storing retrieved data.
*
* @param length Number of bytes to read.
*
* @param repeated if true, stop is not sent at the end. Defaults to false.
*
* @return MICROBIT_OK on success, MICROBIT_I2C_ERROR if an unresolved read failure is detected.
*/
int MicroBitI2C::read(int address, char *data, int length, bool repeated)
{
int result = I2C::read(address,data,length,repeated);
#ifdef MICROBIT_I2C_RESET_IN_FAIL
//0 indicates a success, presume failure
while(result != 0 && retries < MICROBIT_I2C_MAX_RETRIES)
{
_i2c.i2c->EVENTS_ERROR = 0;
_i2c.i2c->ENABLE = TWI_ENABLE_ENABLE_Disabled << TWI_ENABLE_ENABLE_Pos;
_i2c.i2c->POWER = 0;
nrf_delay_us(5);
_i2c.i2c->POWER = 1;
_i2c.i2c->ENABLE = TWI_ENABLE_ENABLE_Enabled << TWI_ENABLE_ENABLE_Pos;
twi_master_init_and_clear();
result = I2C::read(address,data,length,repeated);
retries++;
}
#endif
if(result != 0)
return MICROBIT_I2C_ERROR;
retries = 0;
return MICROBIT_OK;
}
/**
* Performs a complete write transaction. The bottom bit of the address is forced to 0 to indicate a write.
*
* @param address 8-bit I2C slave address [ addr | 0 ]
*
* @param data A pointer to a byte buffer containing the data to write.
*
* @param length Number of bytes to write
*
* @param repeated if true, stop is not sent at the end. Defaults to false.
*
* @return MICROBIT_OK on success, MICROBIT_I2C_ERROR if an unresolved write failure is detected.
*/
int MicroBitI2C::write(int address, const char *data, int length, bool repeated)
{
int result = I2C::write(address,data,length,repeated);
//0 indicates a success, presume failure
#ifdef MICROBIT_I2C_RESET_IN_FAIL
while(result != 0 && retries < MICROBIT_I2C_MAX_RETRIES)
{
_i2c.i2c->EVENTS_ERROR = 0;
_i2c.i2c->ENABLE = TWI_ENABLE_ENABLE_Disabled << TWI_ENABLE_ENABLE_Pos;
_i2c.i2c->POWER = 0;
nrf_delay_us(5);
_i2c.i2c->POWER = 1;
_i2c.i2c->ENABLE = TWI_ENABLE_ENABLE_Enabled << TWI_ENABLE_ENABLE_Pos;
twi_master_init_and_clear();
result = I2C::write(address,data,length,repeated);
retries++;
}
#endif
if(result != 0)
return MICROBIT_I2C_ERROR;
retries = 0;
return MICROBIT_OK;
}
/**
* Issues a standard, 2 byte I2C command write.
*
* Blocks the calling thread until complete.
*
* @param address The address of the I2C device to write to.
* @param reg The address of the register in the device to write.
* @param value The value to write.
*
* @return MICROBIT_OK on success, MICROBIT_I2C_ERROR if the the write request failed.
*/
int MicroBitI2C::writeRegister(uint8_t address, uint8_t reg, uint8_t value)
{
uint8_t command[2];
command[0] = reg;
command[1] = value;
return write(address, (const char *)command, 2);
}
/**
* Issues a read command, copying data into the specified buffer.
*
* Blocks the calling thread until complete.
*
* @param address The address of the I2C device to write to.
* @param reg The address of the register to access.
* @param buffer Memory area to read the data into.
* @param length The number of bytes to read.
*
* @return MICROBIT_OK on success, MICROBIT_INVALID_PARAMETER or MICROBIT_I2C_ERROR if the the read request failed.
*/
int MicroBitI2C::readRegister(uint8_t address, uint8_t reg, uint8_t* buffer, int length)
{
int result;
if (buffer == NULL || length <= 0 )
return MICROBIT_INVALID_PARAMETER;
result = write(address, (const char *)®, 1, true);
if (result !=0)
return MICROBIT_I2C_ERROR;
result = read(address, (char *)buffer, length);
if (result !=0)
return MICROBIT_I2C_ERROR;
return MICROBIT_OK;
}
/**
* Issues a single byte read command, and returns the value read, or an error.
*
* Blocks the calling thread until complete.
*
* @param address The address of the I2C device to write to.
* @param reg The address of the register to access.
*
* @return the byte read on success, MICROBIT_INVALID_PARAMETER or MICROBIT_I2C_ERROR if the the read request failed.
*/
int MicroBitI2C::readRegister(uint8_t address, uint8_t reg)
{
int result;
uint8_t data;
result = readRegister(address, reg, &data, 1);
return (result == MICROBIT_OK) ? (int)data : result;
}
|
