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,59 @@
+#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);
+
+    printf("24LC32 I2C EEPROM example\nStarting test...\n\n");
+
+    // Write the byte at location 0x00 to 0
+    byte_write_eeprom(0x00, 0, I2C_ADDRESS, i2c_default);
+
+    // 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, i2c_default);
+
+    // Read eeprom, and ensure we observe ascending integers from 0 to 31
+    uint8_t result[32];
+    read_eeprom(0x0, result, 32, I2C_ADDRESS, i2c_default);
+
+    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;
+        }
+    }
+    
+    // Now re-write and re-read eeprom
+    printf("\nReversing order...\n\n");
+    for (int i = 0; i < 31; i++) {
+        data_list[i] = 31 - i;
+    }
+    page_write_eeprom(0x00, data_list, 31, I2C_ADDRESS, i2c_default);
+    byte_write_eeprom(0x1F, 0, I2C_ADDRESS, i2c_default);
+
+    // Read eeprom, and ensure we observe descending integers from 31 to 0
+    read_eeprom(0x0, result, 32, I2C_ADDRESS, i2c_default);
+
+    for (int i = 0; i < 32; i++) {
+        printf("read: %i, expected: %i\n", result[i], 31 - i);
+        if (result[i] != 31 - i) {
+            printf("Unexpected read!\n");
+            return 1;
+        }
+    }
+    
+    printf("Test passed!\n");
+    return 0;
+}

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"
+
+bool ack_poll(uint8_t i2c_addr, i2c_inst_t *i2c_instance);
+bool read_eeprom(uint16_t address, uint8_t *result, uint16_t num, uint8_t i2c_addr, i2c_inst_t *i2c_instance);
+bool byte_write_eeprom(uint16_t address, uint8_t data, uint8_t i2c_addr, i2c_inst_t *i2c_instance);
+bool page_write_eeprom(uint16_t address, uint8_t *data, uint8_t num, uint8_t i2c_addr, i2c_inst_t *i2c_instance);
+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,29 @@
+= 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,55 @@
+#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, i2c_default);
+
+    // 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, i2c_default);
+
+    // Read eeprom, and ensure we observe ascending integers from 0 to 31
+    uint8_t result[32];
+    read_eeprom(0x0, result, 32, I2C_ADDRESS, i2c_default);
+
+    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;
+        }
+    }
+    
+    // Now re-write and re-read eeprom
+    for (int i = 0; i < 31; i++) {
+        data_list[i] = 32 - i;
+    }
+    page_write_eeprom(0x1F, data_list, 0, I2C_ADDRESS, i2c_default);
+
+    // Read eeprom, and ensure we observe descending integers from 31 to 0
+    read_eeprom(0x0, result, 32, I2C_ADDRESS, i2c_default);
+
+    for (int i = 0; i < 32; i++) {
+        printf("read: %i, expected: %i\n", result[i], 32 - i);
+        if (result[i] != 32 - i) {
+            printf("Unexpected read!\n");
+            return 1;
+        }
+    }
+    
+    printf("Test passed!\n");
+    return 0;
+}

i2c/24lc32_i2c/README.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()