teralytic / mbed-dev

mbed library sources. Supersedes mbed-src.

Fork of mbed by teralytic

targets/hal/TARGET_ONSEMI/TARGET_NCS36510/i2c_api.c@148:4802eb17e82b, 2016-10-17 (annotated)

Committer:
rodriguise
Date:
Mon Oct 17 18:47:01 2016 +0000
Revision:
148:4802eb17e82b
Parent:
147:30b64687e01f 
backup

Who changed what in which revision?

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