Demo program for library named SD_PlayerSkeleton of SD card player skeleton. SD カードプレーヤのための骨組みとして使うためのライブラリ SD_PlayerSkeleton の使用例.このプログラムについては,CQ出版社インターフェース誌 2018年7月号で解説している.

Dependencies:   F746_GUI F746_SAI_IO SD_PlayerSkeleton

Committer:
MikamiUitOpen
Date:
Sun Oct 02 03:29:34 2016 +0000
Revision:
2:cf42e62a97dc
3

Who changed what in which revision?

UserRevisionLine numberNew contents of line
MikamiUitOpen 2:cf42e62a97dc 1 /* mbed Microcontroller Library
MikamiUitOpen 2:cf42e62a97dc 2 * Copyright (c) 2006-2013 ARM Limited
MikamiUitOpen 2:cf42e62a97dc 3 *
MikamiUitOpen 2:cf42e62a97dc 4 * Licensed under the Apache License, Version 2.0 (the "License");
MikamiUitOpen 2:cf42e62a97dc 5 * you may not use this file except in compliance with the License.
MikamiUitOpen 2:cf42e62a97dc 6 * You may obtain a copy of the License at
MikamiUitOpen 2:cf42e62a97dc 7 *
MikamiUitOpen 2:cf42e62a97dc 8 * http://www.apache.org/licenses/LICENSE-2.0
MikamiUitOpen 2:cf42e62a97dc 9 *
MikamiUitOpen 2:cf42e62a97dc 10 * Unless required by applicable law or agreed to in writing, software
MikamiUitOpen 2:cf42e62a97dc 11 * distributed under the License is distributed on an "AS IS" BASIS,
MikamiUitOpen 2:cf42e62a97dc 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
MikamiUitOpen 2:cf42e62a97dc 13 * See the License for the specific language governing permissions and
MikamiUitOpen 2:cf42e62a97dc 14 * limitations under the License.
MikamiUitOpen 2:cf42e62a97dc 15 */
MikamiUitOpen 2:cf42e62a97dc 16 #ifndef MBED_I2C_SLAVE_H
MikamiUitOpen 2:cf42e62a97dc 17 #define MBED_I2C_SLAVE_H
MikamiUitOpen 2:cf42e62a97dc 18
MikamiUitOpen 2:cf42e62a97dc 19 #include "platform.h"
MikamiUitOpen 2:cf42e62a97dc 20
MikamiUitOpen 2:cf42e62a97dc 21 #if DEVICE_I2CSLAVE
MikamiUitOpen 2:cf42e62a97dc 22
MikamiUitOpen 2:cf42e62a97dc 23 #include "i2c_api.h"
MikamiUitOpen 2:cf42e62a97dc 24
MikamiUitOpen 2:cf42e62a97dc 25 namespace mbed {
MikamiUitOpen 2:cf42e62a97dc 26
MikamiUitOpen 2:cf42e62a97dc 27 /** An I2C Slave, used for communicating with an I2C Master device
MikamiUitOpen 2:cf42e62a97dc 28 *
MikamiUitOpen 2:cf42e62a97dc 29 * Example:
MikamiUitOpen 2:cf42e62a97dc 30 * @code
MikamiUitOpen 2:cf42e62a97dc 31 * // Simple I2C responder
MikamiUitOpen 2:cf42e62a97dc 32 * #include <mbed.h>
MikamiUitOpen 2:cf42e62a97dc 33 *
MikamiUitOpen 2:cf42e62a97dc 34 * I2CSlave slave(p9, p10);
MikamiUitOpen 2:cf42e62a97dc 35 *
MikamiUitOpen 2:cf42e62a97dc 36 * int main() {
MikamiUitOpen 2:cf42e62a97dc 37 * char buf[10];
MikamiUitOpen 2:cf42e62a97dc 38 * char msg[] = "Slave!";
MikamiUitOpen 2:cf42e62a97dc 39 *
MikamiUitOpen 2:cf42e62a97dc 40 * slave.address(0xA0);
MikamiUitOpen 2:cf42e62a97dc 41 * while (1) {
MikamiUitOpen 2:cf42e62a97dc 42 * int i = slave.receive();
MikamiUitOpen 2:cf42e62a97dc 43 * switch (i) {
MikamiUitOpen 2:cf42e62a97dc 44 * case I2CSlave::ReadAddressed:
MikamiUitOpen 2:cf42e62a97dc 45 * slave.write(msg, strlen(msg) + 1); // Includes null char
MikamiUitOpen 2:cf42e62a97dc 46 * break;
MikamiUitOpen 2:cf42e62a97dc 47 * case I2CSlave::WriteGeneral:
MikamiUitOpen 2:cf42e62a97dc 48 * slave.read(buf, 10);
MikamiUitOpen 2:cf42e62a97dc 49 * printf("Read G: %s\n", buf);
MikamiUitOpen 2:cf42e62a97dc 50 * break;
MikamiUitOpen 2:cf42e62a97dc 51 * case I2CSlave::WriteAddressed:
MikamiUitOpen 2:cf42e62a97dc 52 * slave.read(buf, 10);
MikamiUitOpen 2:cf42e62a97dc 53 * printf("Read A: %s\n", buf);
MikamiUitOpen 2:cf42e62a97dc 54 * break;
MikamiUitOpen 2:cf42e62a97dc 55 * }
MikamiUitOpen 2:cf42e62a97dc 56 * for(int i = 0; i < 10; i++) buf[i] = 0; // Clear buffer
MikamiUitOpen 2:cf42e62a97dc 57 * }
MikamiUitOpen 2:cf42e62a97dc 58 * }
MikamiUitOpen 2:cf42e62a97dc 59 * @endcode
MikamiUitOpen 2:cf42e62a97dc 60 */
MikamiUitOpen 2:cf42e62a97dc 61 class I2CSlave {
MikamiUitOpen 2:cf42e62a97dc 62
MikamiUitOpen 2:cf42e62a97dc 63 public:
MikamiUitOpen 2:cf42e62a97dc 64 enum RxStatus {
MikamiUitOpen 2:cf42e62a97dc 65 NoData = 0,
MikamiUitOpen 2:cf42e62a97dc 66 ReadAddressed = 1,
MikamiUitOpen 2:cf42e62a97dc 67 WriteGeneral = 2,
MikamiUitOpen 2:cf42e62a97dc 68 WriteAddressed = 3
MikamiUitOpen 2:cf42e62a97dc 69 };
MikamiUitOpen 2:cf42e62a97dc 70
MikamiUitOpen 2:cf42e62a97dc 71 /** Create an I2C Slave interface, connected to the specified pins.
MikamiUitOpen 2:cf42e62a97dc 72 *
MikamiUitOpen 2:cf42e62a97dc 73 * @param sda I2C data line pin
MikamiUitOpen 2:cf42e62a97dc 74 * @param scl I2C clock line pin
MikamiUitOpen 2:cf42e62a97dc 75 */
MikamiUitOpen 2:cf42e62a97dc 76 I2CSlave(PinName sda, PinName scl);
MikamiUitOpen 2:cf42e62a97dc 77
MikamiUitOpen 2:cf42e62a97dc 78 /** Set the frequency of the I2C interface
MikamiUitOpen 2:cf42e62a97dc 79 *
MikamiUitOpen 2:cf42e62a97dc 80 * @param hz The bus frequency in hertz
MikamiUitOpen 2:cf42e62a97dc 81 */
MikamiUitOpen 2:cf42e62a97dc 82 void frequency(int hz);
MikamiUitOpen 2:cf42e62a97dc 83
MikamiUitOpen 2:cf42e62a97dc 84 /** Checks to see if this I2C Slave has been addressed.
MikamiUitOpen 2:cf42e62a97dc 85 *
MikamiUitOpen 2:cf42e62a97dc 86 * @returns
MikamiUitOpen 2:cf42e62a97dc 87 * A status indicating if the device has been addressed, and how
MikamiUitOpen 2:cf42e62a97dc 88 * - NoData - the slave has not been addressed
MikamiUitOpen 2:cf42e62a97dc 89 * - ReadAddressed - the master has requested a read from this slave
MikamiUitOpen 2:cf42e62a97dc 90 * - WriteAddressed - the master is writing to this slave
MikamiUitOpen 2:cf42e62a97dc 91 * - WriteGeneral - the master is writing to all slave
MikamiUitOpen 2:cf42e62a97dc 92 */
MikamiUitOpen 2:cf42e62a97dc 93 int receive(void);
MikamiUitOpen 2:cf42e62a97dc 94
MikamiUitOpen 2:cf42e62a97dc 95 /** Read from an I2C master.
MikamiUitOpen 2:cf42e62a97dc 96 *
MikamiUitOpen 2:cf42e62a97dc 97 * @param data pointer to the byte array to read data in to
MikamiUitOpen 2:cf42e62a97dc 98 * @param length maximum number of bytes to read
MikamiUitOpen 2:cf42e62a97dc 99 *
MikamiUitOpen 2:cf42e62a97dc 100 * @returns
MikamiUitOpen 2:cf42e62a97dc 101 * 0 on success,
MikamiUitOpen 2:cf42e62a97dc 102 * non-0 otherwise
MikamiUitOpen 2:cf42e62a97dc 103 */
MikamiUitOpen 2:cf42e62a97dc 104 int read(char *data, int length);
MikamiUitOpen 2:cf42e62a97dc 105
MikamiUitOpen 2:cf42e62a97dc 106 /** Read a single byte from an I2C master.
MikamiUitOpen 2:cf42e62a97dc 107 *
MikamiUitOpen 2:cf42e62a97dc 108 * @returns
MikamiUitOpen 2:cf42e62a97dc 109 * the byte read
MikamiUitOpen 2:cf42e62a97dc 110 */
MikamiUitOpen 2:cf42e62a97dc 111 int read(void);
MikamiUitOpen 2:cf42e62a97dc 112
MikamiUitOpen 2:cf42e62a97dc 113 /** Write to an I2C master.
MikamiUitOpen 2:cf42e62a97dc 114 *
MikamiUitOpen 2:cf42e62a97dc 115 * @param data pointer to the byte array to be transmitted
MikamiUitOpen 2:cf42e62a97dc 116 * @param length the number of bytes to transmite
MikamiUitOpen 2:cf42e62a97dc 117 *
MikamiUitOpen 2:cf42e62a97dc 118 * @returns
MikamiUitOpen 2:cf42e62a97dc 119 * 0 on success,
MikamiUitOpen 2:cf42e62a97dc 120 * non-0 otherwise
MikamiUitOpen 2:cf42e62a97dc 121 */
MikamiUitOpen 2:cf42e62a97dc 122 int write(const char *data, int length);
MikamiUitOpen 2:cf42e62a97dc 123
MikamiUitOpen 2:cf42e62a97dc 124 /** Write a single byte to an I2C master.
MikamiUitOpen 2:cf42e62a97dc 125 *
MikamiUitOpen 2:cf42e62a97dc 126 * @data the byte to write
MikamiUitOpen 2:cf42e62a97dc 127 *
MikamiUitOpen 2:cf42e62a97dc 128 * @returns
MikamiUitOpen 2:cf42e62a97dc 129 * '1' if an ACK was received,
MikamiUitOpen 2:cf42e62a97dc 130 * '0' otherwise
MikamiUitOpen 2:cf42e62a97dc 131 */
MikamiUitOpen 2:cf42e62a97dc 132 int write(int data);
MikamiUitOpen 2:cf42e62a97dc 133
MikamiUitOpen 2:cf42e62a97dc 134 /** Sets the I2C slave address.
MikamiUitOpen 2:cf42e62a97dc 135 *
MikamiUitOpen 2:cf42e62a97dc 136 * @param address The address to set for the slave (ignoring the least
MikamiUitOpen 2:cf42e62a97dc 137 * signifcant bit). If set to 0, the slave will only respond to the
MikamiUitOpen 2:cf42e62a97dc 138 * general call address.
MikamiUitOpen 2:cf42e62a97dc 139 */
MikamiUitOpen 2:cf42e62a97dc 140 void address(int address);
MikamiUitOpen 2:cf42e62a97dc 141
MikamiUitOpen 2:cf42e62a97dc 142 /** Reset the I2C slave back into the known ready receiving state.
MikamiUitOpen 2:cf42e62a97dc 143 */
MikamiUitOpen 2:cf42e62a97dc 144 void stop(void);
MikamiUitOpen 2:cf42e62a97dc 145
MikamiUitOpen 2:cf42e62a97dc 146 protected:
MikamiUitOpen 2:cf42e62a97dc 147 i2c_t _i2c;
MikamiUitOpen 2:cf42e62a97dc 148 };
MikamiUitOpen 2:cf42e62a97dc 149
MikamiUitOpen 2:cf42e62a97dc 150 } // namespace mbed
MikamiUitOpen 2:cf42e62a97dc 151
MikamiUitOpen 2:cf42e62a97dc 152 #endif
MikamiUitOpen 2:cf42e62a97dc 153
MikamiUitOpen 2:cf42e62a97dc 154 #endif