Added 24LC32 EEPROM I2C example

Author: Louis31423142

README.md

@@ -159,6 +159,7 @@ App|Description
 [ht16k33_i2c](i2c/ht16k33_i2c) | Drive a 4 digit 14 segment LED with an HT16K33.
 [slave_mem_i2c](i2c/slave_mem_i2c) | i2c slave example where the slave implements a 256 byte memory.
 [slave_mem_i2c_burst](i2c/slave_mem_i2c) | i2c slave example where the slave implements a 256 byte memory. This version inefficiently writes each byte in a separate call to demonstrate read and write burst mode.
+[24lc32_i2c](i2c/24lc32_i2c) | Read and write data to 24LC32 EEPROM via I2C.
 
 ### Interpolator
 

i2c/24lc32_i2c/24lc32_i2c.fzz

@@ -0,0 +1,85 @@
+#include <stdio.h>
+#include "pico/stdlib.h"
+#include "hardware/i2c.h"
+
+// This is the max number of bytes which can be written at once during a page write
+#define MAX_PAGE_WRITE 32
+
+// Acknowledge polling can be used to see when a write cycle is complete
+// Wait for the i2c slave to acknowledge our empty write
+bool ack_poll(uint8_t i2c_addr) {
+    int timeout = 100;
+    for (int i = 0; i < timeout; i++) {
+        if (i2c_write_blocking(i2c_default, i2c_addr, NULL, 1, false) == 1) {
+            return true;
+        }
+        sleep_ms(1);
+    }
+    printf("ack timeout\n");
+    return false;
+}
+
+// Read num bytes of memory starting at given address into result
+void read_eeprom(uint16_t address, uint8_t *result, uint16_t num, uint8_t i2c_addr) {
+    for (int i = 0; i < num; i++) {
+        uint8_t byte1 = (uint8_t)(address >> 8);
+        uint8_t byte2 = (uint8_t)(address);
+
+        uint8_t buf[2] = {byte1, byte2};
+
+        i2c_write_blocking(i2c_default, i2c_addr, buf, 2, true);
+        i2c_read_blocking(i2c_default, i2c_addr, (result + i), 1, false);
+
+        address++;
+    }
+}
+
+// Write a single byte of data at a specified address in memory
+void byte_write_eeprom(uint16_t address, uint8_t data, uint8_t i2c_addr) {
+    uint8_t byte1 = (uint8_t)(address >> 8);
+    uint8_t byte2 = (uint8_t)(address);
+
+    uint8_t buf[3] = {byte1, byte2, data};
+
+    i2c_write_blocking(i2c_default, i2c_addr, buf, 3, false);
+
+    // ack_poll to wait for write to be complete
+    ack_poll(i2c_addr);
+}
+
+// Write a block of data to eeprom 
+// Returns false if more than MAX_PAGE_WRITE bytes passed in, which would lead to overwriting of data
+bool page_write_eeprom(uint16_t address, uint8_t *data, uint8_t num, uint8_t i2c_addr) {
+    if (num > MAX_PAGE_WRITE) {
+        printf("Tried to write more than 32 bytes.\n");
+        return false;
+    }
+
+    uint8_t byte1 = (uint8_t)(address >> 8);
+    uint8_t byte2 = (uint8_t)(address);
+    uint8_t buf[2 + num];
+    buf[0] = byte1;
+    buf[1] = byte2;
+
+    // transfer data into buffer
+    for (int i = 0; i < num; i++) {
+        buf[i + 2] = data[i];
+    }
+
+    i2c_write_blocking(i2c_default, i2c_addr, buf, 2 + num, false);
+
+    // ack_poll to wait for write to be complete
+    ack_poll(i2c_addr);
+    return true;
+}
+
+// Initialise i2c for given gpio at given frequency
+void eeprom_init(int sda_pin, int scl_pin, int freq, i2c_inst_t *i2c_instance) {
+    i2c_init(i2c_default, freq);
+    
+    gpio_set_function(sda_pin, GPIO_FUNC_I2C);
+    gpio_set_function(scl_pin, GPIO_FUNC_I2C);
+    gpio_pull_up(sda_pin);
+    gpio_pull_up(scl_pin);
+}
+

i2c/24lc32_i2c/24lc32_i2c.png

@@ -0,0 +1,12 @@
+#ifndef PICO_I2C_EEPROM_LIB_H
+#define PICO_I2C_EEPROM_LIB_H
+
+#include "hardware/i2c.h"
+
+void read_eeprom(uint16_t address, uint8_t *result, uint16_t num, uint8_t i2c_addr);
+void byte_write_eeprom(uint16_t address, uint8_t data, uint8_t i2c_addr);
+bool page_write_eeprom(uint16_t address, uint8_t *data, uint8_t num, uint8_t i2c_addr);
+bool ack_poll(uint8_t i2c_addr);
+void eeprom_init(int sda_pin, int scl_pin, int freq, i2c_inst_t *i2c_instance);
+
+#endif

i2c/24lc32_i2c/24lc32_i2c_lib.c

@@ -0,0 +1,25 @@
+# Add libary
+add_library(24lc32_i2c_lib INTERFACE)
+target_sources(24lc32_i2c_lib INTERFACE
+        ${CMAKE_CURRENT_LIST_DIR}/24lc32_i2c_lib.c
+        )
+target_include_directories(24lc32_i2c_lib INTERFACE
+        ${CMAKE_CURRENT_LIST_DIR}
+        )
+target_link_libraries(24lc32_i2c_lib INTERFACE
+        pico_stdlib
+        hardware_i2c
+        )
+
+# Add executable 
+add_executable(24lc32_i2c 
+        example.c 
+        )
+
+target_link_libraries(24lc32_i2c
+        24lc32_i2c_lib
+        pico_stdlib
+        hardware_i2c
+        )
+
+pico_add_extra_outputs(24lc32_i2c)

i2c/24lc32_i2c/24lc32_i2c_lib.h

@@ -0,0 +1,30 @@
+= Reading and writing 24LC32 EEPROM via I2C
+
+This example code demonstrates how to read and write data from 24LC32 EEPROM. It contains a library with functions for reading data, writing single bytes, and writing pages, and an example which uses these functions.
+
+== Wiring information
+
+[[24lc32_i2c_wiring]]
+[pdfwidth=75%]
+.Wiring Diagram for 24LC32 EEPROM via I2C.
+image::24lc32_i2c.png[]
+
+== List of Files
+
+CMakeLists.txt:: CMake file to incorporate the example into the examples build tree.
+24lc32_i2c_lib.c:: Library containing functions to interact with 24LC32 eeprom via I2C.
+24lc32_i2c_lib.h:: Header file containing function declarations for the 24LC32 library.
+example.c:: The example code.
+
+== Bill of Materials
+
+.A list of materials required for the example
+[[24lc32_i2c-bom-table]]
+[cols=3]
+|===
+| *Item* | *Quantity* | Details
+| Breadboard | 1 | generic part
+| Raspberry Pi Pico (any) | 1 | https://www.raspberrypi.com/products/raspberry-pi-pico/
+| 24LC32-based breakout board | 1 | https://www.adafruit.com/product/5146
+| M/M Jumper wires | 4 | generic part
+|===

i2c/24lc32_i2c/CMakeLists.txt

@@ -0,0 +1,38 @@
+#include <stdio.h>
+#include "pico/stdlib.h"
+#include "hardware/i2c.h"
+#include "24lc32_i2c_lib.h"
+
+// Default I2C address of 24LC32
+#define I2C_ADDRESS 0x50
+
+int main() {
+    stdio_init_all();
+
+    eeprom_init(PICO_DEFAULT_I2C_SDA_PIN, PICO_DEFAULT_I2C_SCL_PIN, 400*1000, i2c_default);
+
+    // Write the byte at location 0x00 to 0
+    byte_write_eeprom(0x00, 0, I2C_ADDRESS);
+
+    // Make an array of integers from 1 to 31 and write the array to eeprom starting at 0x01
+    uint8_t data_list[31];
+    for (int i = 0; i < 31; i++) {
+        data_list[i] = i + 1;
+    }
+    page_write_eeprom(0x01, data_list, 31, I2C_ADDRESS);
+
+    // Read eeprom, and ensure we observe ascending integers from 0 to 31
+    uint8_t result[32];
+    read_eeprom(0x0, result, 32, I2C_ADDRESS);
+
+    for (int i = 0; i < 32; i++) {
+        printf("read: %i, expected: %i\n", result[i], i);
+        if (result[i] != i) {
+            printf("Unexpected read!\n");
+            return 1;
+        }
+    }
+    
+    printf("Test passed!\n");
+    return 0;
+}

i2c/24lc32_i2c/READ_ME.adoc

@@ -12,6 +12,7 @@ if (TARGET hardware_i2c)
     add_subdirectory_exclude_platforms(pcf8523_i2c)
     add_subdirectory_exclude_platforms(ht16k33_i2c)
     add_subdirectory_exclude_platforms(slave_mem_i2c)
+    add_subdirectory_exclude_platforms(24lc32_i2c)
 else()
     message("Skipping I2C examples as hardware_i2c is unavailable on this platform")
 endif()