mbed library sources
Fork of mbed-src by
Diff: cpp/I2C.h
- Revision:
- 9:0ce32e54c9a7
- Parent:
- 8:4e25b8576136
- Child:
- 10:3bc89ef62ce7
--- a/cpp/I2C.h Thu May 30 16:59:31 2013 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,144 +0,0 @@ -/* mbed Microcontroller Library - * Copyright (c) 2006-2013 ARM Limited - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -#ifndef MBED_I2C_H -#define MBED_I2C_H - -#include "platform.h" - -#if DEVICE_I2C - -#include "i2c_api.h" - -namespace mbed { - -/** An I2C Master, used for communicating with I2C slave devices - * - * Example: - * @code - * // Read from I2C slave at address 0x62 - * - * #include "mbed.h" - * - * I2C i2c(p28, p27); - * - * int main() { - * int address = 0x62; - * char data[2]; - * i2c.read(address, data, 2); - * } - * @endcode - */ -class I2C { - -public: - enum RxStatus { - NoData, - MasterGeneralCall, - MasterWrite, - MasterRead - }; - - enum Acknowledge { - NoACK = 0, - ACK = 1 - }; - - /** Create an I2C Master interface, connected to the specified pins - * - * @param sda I2C data line pin - * @param scl I2C clock line pin - */ - I2C(PinName sda, PinName scl); - - /** Set the frequency of the I2C interface - * - * @param hz The bus frequency in hertz - */ - void frequency(int hz); - - /** Read from an I2C slave - * - * 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 Pointer to the byte-array to read data in to - * @param length Number of bytes to read - * @param repeated Repeated start, true - don't send stop at end - * - * @returns - * 0 on success (ack), - * non-0 on failure (nack) - */ - int read(int address, char *data, int length, bool repeated = false); - - /** Read a single byte from the I2C bus - * - * @param ack indicates if the byte is to be acknowledged (1 = acknowledge) - * - * @returns - * the byte read - */ - int read(int ack); - - /** Write to an I2C slave - * - * 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 Pointer to the byte-array data to send - * @param length Number of bytes to send - * @param repeated Repeated start, true - do not send stop at end - * - * @returns - * 0 on success (ack), - * non-0 on failure (nack) - */ - int write(int address, const char *data, int length, bool repeated = false); - - /** Write single byte out on the I2C bus - * - * @param data data to write out on bus - * - * @returns - * '1' if an ACK was received, - * '0' otherwise - */ - int write(int data); - - /** Creates a start condition on the I2C bus - */ - - void start(void); - - /** Creates a stop condition on the I2C bus - */ - void stop(void); - -protected: - void aquire(); - - i2c_t _i2c; - static I2C *_owner; - int _hz; -}; - -} // namespace mbed - -#endif - -#endif