Ben Katz / mbed-dev-f303

mbed library sources. Supersedes mbed-src.

Dependents:   Hobbyking_Cheetah_Compact Hobbyking_Cheetah_Compact_DRV8323_14bit Hobbyking_Cheetah_Compact_DRV8323_V51_201907 HKC_MiniCheetah ... more

Fork of mbed-dev by mbed official

targets/TARGET_ONSEMI/TARGET_NCS36510/i2c_api.c@159:612c381a210f, 2017-02-28 (annotated)

Committer:
<>
Date:
Tue Feb 28 17:13:35 2017 +0000
Revision:
159:612c381a210f
Parent:
149:156823d33999
Child:
160:d5399cc887bb
This updates the lib to the mbed lib v137

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 149:156823d33999 1 /**
<> 149:156823d33999 2 *******************************************************************************
<> 149:156823d33999 3 * @file i2c.c
<> 149:156823d33999 4 * @brief Implementation of an i2c api
<> 149:156823d33999 5 * @internal
<> 149:156823d33999 6 * @author ON Semiconductor
<> 149:156823d33999 7 * $Rev: 3525 $
<> 149:156823d33999 8 * $Date: 2015-07-20 15:24:25 +0530 (Mon, 20 Jul 2015) $
<> 149:156823d33999 9 ******************************************************************************
<> 149:156823d33999 10 * Copyright 2016 Semiconductor Components Industries LLC (d/b/a “ON Semiconductor”).
<> 149:156823d33999 11 * All rights reserved. This software and/or documentation is licensed by ON Semiconductor
<> 149:156823d33999 12 * under limited terms and conditions. The terms and conditions pertaining to the software
<> 149:156823d33999 13 * and/or documentation are available at http://www.onsemi.com/site/pdf/ONSEMI_T&C.pdf
<> 149:156823d33999 14 * (“ON Semiconductor Standard Terms and Conditions of Sale, Section 8 Software”) and
<> 149:156823d33999 15 * if applicable the software license agreement. Do not use this software and/or
<> 149:156823d33999 16 * documentation unless you have carefully read and you agree to the limited terms and
<> 149:156823d33999 17 * conditions. By using this software and/or documentation, you agree to the limited
<> 149:156823d33999 18 * terms and conditions.
<> 149:156823d33999 19 *
<> 149:156823d33999 20 * THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED
<> 149:156823d33999 21 * OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF
<> 149:156823d33999 22 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE.
<> 149:156823d33999 23 * ON SEMICONDUCTOR SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL,
<> 149:156823d33999 24 * INCIDENTAL, OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER.
<> 149:156823d33999 25 * @endinternal
<> 149:156823d33999 26 *
<> 149:156823d33999 27 * @ingroup i2c
<> 149:156823d33999 28 *
<> 149:156823d33999 29 */
<> 149:156823d33999 30 #if DEVICE_I2C
<> 149:156823d33999 31
<> 149:156823d33999 32 #include "i2c.h"
<> 149:156823d33999 33 #include "i2c_api.h"
<> 159:612c381a210f 34 #include "wait_api.h"
<> 149:156823d33999 35
<> 149:156823d33999 36 #define I2C_READ_WRITE_BIT_MASK 0xFE
<> 149:156823d33999 37
<> 149:156823d33999 38 /* See i2c_api.h for details */
<> 149:156823d33999 39 void i2c_init(i2c_t *obj, PinName sda, PinName scl)
<> 149:156823d33999 40 {
<> 149:156823d33999 41 fI2cInit(obj, sda, scl);
<> 149:156823d33999 42 }
<> 149:156823d33999 43
<> 149:156823d33999 44 /* See i2c_api.h for details */
<> 149:156823d33999 45 void i2c_frequency(i2c_t *obj, int hz)
<> 149:156823d33999 46 {
<> 149:156823d33999 47 fI2cFrequency(obj, hz);
<> 149:156823d33999 48 }
<> 149:156823d33999 49
<> 149:156823d33999 50 /* See i2c_api.h for details */
<> 149:156823d33999 51 int i2c_start(i2c_t *obj)
<> 149:156823d33999 52 {
<> 149:156823d33999 53 return(fI2cStart(obj));
<> 149:156823d33999 54 }
<> 149:156823d33999 55
<> 149:156823d33999 56 /* See i2c_api.h for details */
<> 149:156823d33999 57 int i2c_stop(i2c_t *obj)
<> 149:156823d33999 58 {
<> 149:156823d33999 59 return(fI2cStop(obj));
<> 149:156823d33999 60 }
<> 149:156823d33999 61
<> 149:156823d33999 62 /* See i2c_api.h for details */
<> 149:156823d33999 63 int i2c_read(i2c_t *obj, int address, char *data, int length, int stop)
<> 149:156823d33999 64 {
<> 149:156823d33999 65 /* TODO address parameter not usable */
<> 149:156823d33999 66 int Count, status;
<> 149:156823d33999 67 const char WriteData = (address | (~I2C_READ_WRITE_BIT_MASK)) & 0xFF;
<> 149:156823d33999 68
<> 149:156823d33999 69 /* Send start bit */
<> 149:156823d33999 70 status = fI2cStart(obj);
<> 149:156823d33999 71 if(status) {
<> 149:156823d33999 72 /* Error sending start bit */
<> 149:156823d33999 73 return status;
<> 149:156823d33999 74 }
<> 149:156823d33999 75
<> 149:156823d33999 76 /* Send address | read */
<> 149:156823d33999 77 Count = fI2cWriteB(obj, &WriteData, 1);
<> 149:156823d33999 78 if(Count != 1) {
<> 149:156823d33999 79 /* Error sending address */
<> 149:156823d33999 80 return Count;
<> 149:156823d33999 81 }
<> 149:156823d33999 82
<> 149:156823d33999 83 /* Send command/s */
<> 149:156823d33999 84 Count = fI2cReadB(obj, data, length);
<> 149:156823d33999 85 if(Count != length) {
<> 149:156823d33999 86 /* Error sending coomand/s */
<> 149:156823d33999 87 return Count;
<> 149:156823d33999 88 }
<> 149:156823d33999 89 if(stop) { /* Send stop bit if requested */
<> 149:156823d33999 90 status = fI2cStop(obj);
<> 149:156823d33999 91 if(status) {
<> 149:156823d33999 92 /* Error sending stop bit */
<> 149:156823d33999 93 return status;
<> 149:156823d33999 94 }
<> 149:156823d33999 95 }
<> 149:156823d33999 96 return Count;
<> 149:156823d33999 97 }
<> 149:156823d33999 98
<> 149:156823d33999 99 /* See i2c_api.h for details */
<> 149:156823d33999 100 int i2c_write(i2c_t *obj, int address, const char *data, int length, int stop)
<> 149:156823d33999 101 {
<> 149:156823d33999 102 int Count, status;
<> 149:156823d33999 103 const char WriteData = (address & I2C_READ_WRITE_BIT_MASK) & 0xFF;
<> 149:156823d33999 104
<> 149:156823d33999 105 /* Send start bit */
<> 149:156823d33999 106 status = fI2cStart(obj);
<> 149:156823d33999 107 if(status) {
<> 149:156823d33999 108 /* Error sending start bit */
<> 149:156823d33999 109 return status;
<> 149:156823d33999 110 }
<> 149:156823d33999 111
<> 149:156823d33999 112 /* Send address | write */
<> 149:156823d33999 113 Count = fI2cWriteB(obj, &WriteData, 1);
<> 149:156823d33999 114 if(Count != 1) {
<> 149:156823d33999 115 /* Error sending address */
<> 149:156823d33999 116 return Count;
<> 149:156823d33999 117 }
<> 149:156823d33999 118
<> 149:156823d33999 119 /* Sens command, [data] */
<> 149:156823d33999 120 Count = fI2cWriteB(obj, data, length);
<> 149:156823d33999 121 if(Count != length) {
<> 149:156823d33999 122 /* Error sending address */
<> 149:156823d33999 123 return Count;
<> 149:156823d33999 124 }
<> 149:156823d33999 125
<> 149:156823d33999 126 if(stop) { /* If stop requested */
<> 149:156823d33999 127 /* Send stop bit */
<> 149:156823d33999 128 status = fI2cStop(obj);
<> 149:156823d33999 129 if(status) {
<> 149:156823d33999 130 /* Error sending stop bit */
<> 149:156823d33999 131 return status;
<> 149:156823d33999 132 }
<> 149:156823d33999 133 }
<> 149:156823d33999 134 return Count;
<> 149:156823d33999 135 }
<> 149:156823d33999 136
<> 149:156823d33999 137 /* See i2c_api.h for details */
<> 149:156823d33999 138 void i2c_reset(i2c_t *obj)
<> 149:156823d33999 139 {
<> 149:156823d33999 140 (void)fI2cStop(obj);
<> 149:156823d33999 141 }
<> 149:156823d33999 142
<> 149:156823d33999 143 /* See i2c_api.h for details */
<> 149:156823d33999 144 int i2c_byte_read(i2c_t *obj, int last) /* TODO return size can be uint8_t */
<> 149:156823d33999 145 {
<> 149:156823d33999 146 int Count;
<> 149:156823d33999 147 char data;
<> 149:156823d33999 148 Count = fI2cReadB(obj, &data, 1);
<> 149:156823d33999 149 if(Count != 1) {
<> 149:156823d33999 150 /* Error */
<> 149:156823d33999 151 return Count;
<> 149:156823d33999 152 }
<> 149:156823d33999 153 if(last) {
<> 149:156823d33999 154 /* ACK */
<> 159:612c381a210f 155 SEND_COMMAND(I2C_CMD_WDAT0);
<> 149:156823d33999 156 } else {
<> 149:156823d33999 157 /* No ACK */
<> 159:612c381a210f 158 SEND_COMMAND(I2C_CMD_WDAT1);
<> 149:156823d33999 159 }
<> 149:156823d33999 160 return data;
<> 149:156823d33999 161 }
<> 149:156823d33999 162
<> 149:156823d33999 163 /* See i2c_api.h for details */
<> 149:156823d33999 164 int i2c_byte_write(i2c_t *obj, int data)
<> 149:156823d33999 165 {
<> 149:156823d33999 166 int Count;
<> 149:156823d33999 167 Count = fI2cWriteB(obj, (const char *)&data, 1);
<> 149:156823d33999 168 if(Count != 1) {
<> 149:156823d33999 169 return Count;
<> 149:156823d33999 170 }
<> 149:156823d33999 171
<> 149:156823d33999 172 while(obj->membase->STATUS.WORD & I2C_STATUS_CMD_FIFO_OFL_BIT); /* Wait till command overflow ends */
<> 149:156823d33999 173
<> 149:156823d33999 174 if(obj->membase->STATUS.WORD & I2C_STATUS_BUS_ERR_BIT) {
<> 149:156823d33999 175 /* Bus error means NAK received */
<> 149:156823d33999 176 return 0;
<> 149:156823d33999 177 } else {
<> 149:156823d33999 178 /* ACK received */
<> 149:156823d33999 179 return 1;
<> 149:156823d33999 180 }
<> 149:156823d33999 181 }
<> 149:156823d33999 182
<> 159:612c381a210f 183 #endif /* DEVICE_I2C */