Getting Started With The mbed-os Example for the I2C EEPROM Block Device

This is the mbed-os example for the I2CEEBlockDevice driver. See the i2ceeprom-driver repository for more information.

This guide outlines the steps to get the I2C EEPROM part working on an mbed OS platform fitted with the CI Test Shield.

Please install mbed CLI.

Hardware Requirements

This example can be used on an mbedos platform with a CI Test Shield inserted into the Arduino header.

This document uses the K64F as an example. Simply change the relevant options (e.g. -m K64F) to be appropriate for your target.

Create the Example Application

From the command-line, import the example:

mbed import mbed-os-example-i2ceeprom-driver

You should see:

[mbed] Importing program "mbed-os-example-i2ceeprom-driver" from "https://github.com/ARMmbed/mbed-os-example-i2ceeprom-driver" at latest revision in the current branch
[mbed] Adding library "mbed-os" from "https://github.com/ARMmbed/mbed-os" at rev #f4864dc6429e

Move into the newly created directory:

cd mbed-os-example-i2ceeprom-driver

If the mbed-os library was not automatically added (see trace above), do the following to import mbed-os:

mbed new .

Build the Example

Invoke mbed compile, and specify the name of your platform and your favorite toolchain (GCC_ARM, ARM, IAR). For example, for the GCC_ARM toolchain:

mbed compile -m K64F -t GCC_ARM

Your PC may take a few minutes to compile your code. At the end, you see the following result:

[snip]
Link: mbed-os-example-i2ceeprom-driver
Elf2Bin: mbed-os-example-i2ceeprom-driver
+--------------------------+-------+-------+-------+
| Module                   | .text | .data |  .bss |
+--------------------------+-------+-------+-------+
| Fill                     |    78 |     4 |  2449 |
| Misc                     | 33150 |  2212 |   116 |
| drivers                  |   574 |     0 |    32 |
| features/storage         |    42 |     0 |   184 |
| hal                      |   450 |     0 |     8 |
| platform                 |  1232 |     4 |   269 |
| rtos                     |   135 |     4 |     4 |
| rtos/rtx                 |  5915 |    20 |  6870 |
| targets/TARGET_Freescale | 12304 |    12 |   388 |
| Subtotals                | 53880 |  2256 | 10320 |
+--------------------------+-------+-------+-------+
Allocated Heap: 24576 bytes
Allocated Stack: unknown
Total Static RAM memory (data + bss): 12576 bytes
Total RAM memory (data + bss + heap + stack): 37152 bytes
Total Flash memory (text + data + misc): 57176 bytes

Image: .\BUILD\K64F\GCC_ARM\mbed-os-example-i2ceeprom-driver.bin

Run the Example Binary on the K64F

Copy the binary from <root_dir>/mbed-os-example-i2ceeprom-driver/BUILD/K64F/GCC_ARM/mbed-os-example-i2ceeprom-driver.bin to the K64F:

1. Connect your mbed device to the computer over USB.
2. Copy the binary file to the mbed device.
3. Press the reset button to start the program.
4. Open the UART of the board in your favorite UART viewing program. For example, screen /dev/ttyACM0.

After connecting a serial console and resetting the target, the following trace should be seen:

i2cee size: 32768
i2cee read size: 1
i2cee program size: 1
i2cee erase size: 1
Hello World!

Troubleshooting

1. Make sure mbed-cli is working correctly and its version is newer than 1.0.0.

mbed --version

If not, update it:

pip install mbed-cli --upgrade