[ZSC31014]STM32L432KC에서 I2C통신으로 EEPROM 데이터 읽기와 쓰기 코드 구현

아래는 STM32L432KC 마이크로컨트롤러에서 ZSC31014의 EEPROM 데이터를 I²C 인터페이스를 통해 전체 읽기/쓰기 및 특정 번지 읽기/쓰기를 수행하는 C 코드를 제공합니다. 코드 작성은 STM32 HAL 라이브러리를 기반으로 하며, ZSC31014 데이터시트(REN_ZSC31014_DST_20160120_1.pdf, 페이지 33~37, 38~43)를 참조하여 구현했습니다.

가정 및 설정

• MCU: STM32L432KC, HAL 라이브러리 사용.
• I²C 설정:
  • ZSC31014 기본 슬레이브 주소: 0x28 (EEPROM 워드 02HEX, 비트 [9:3], 왼쪽 시프트 후 WRITE 비트 포함).
  • I²C 클럭 속도: 100kHz (ZSC31014는 100kHz 또는 400kHz 지원, 페이지 20).
• EEPROM 워드: 00HEX ~ 13HEX (총 20개 워드, 16비트, 페이지 38~43, Table 3.7).
• 명령:
  • Command Mode 진입: Start_CM (A0HEX, 페이지 37).
  • EEPROM 읽기: 00HEX ~ 13HEX (페이지 37, Table 3.6).
  • EEPROM 쓰기: 40HEX ~ 53HEX.
  • Normal Operation Mode 복귀: Start_NOM (80HEX).
• 주의사항:
  • T_Config (워드 10HEX), Osc_Trim (워드 11HEX)은 공장 설정 유지 권장(페이지 41).
  • 쓰기 후 Start_NOM으로 서명 업데이트 필수(페이지 37).
  • 전원 켜짐 후 6ms 이내 Start_CM 실행(페이지 37).
  • STM32L432KC의 I²C HAL 함수(HAL_I2C_Master_Transmit, HAL_I2C_Master_Receive) 사용.

코드

#include "stm32l4xx_hal.h"
#include <string.h>
#include <stdio.h>

// I2C 핸들러 (STM32CubeMX에서 설정된 I2C1 사용 가정)
extern I2C_HandleTypeDef hi2c1;

// ZSC31014 I2C 슬레이브 주소 (7비트 주소: 0x28, 데이터시트 페이지 20)
#define ZSC31014_I2C_ADDR (0x28 << 1) // 7비트 주소 왼쪽 시프트

// 명령 코드 (데이터시트 페이지 37, Table 3.6)
#define CMD_START_CM  0xA0 // Command Mode 진입
#define CMD_START_NOM 0x80 // Normal Operation Mode 복귀
#define CMD_EEPROM_READ_BASE  0x00 // EEPROM 읽기 명령 기본값 (0x00 ~ 0x13)
#define CMD_EEPROM_WRITE_BASE 0x40 // EEPROM 쓰기 명령 기본값 (0x40 ~ 0x53)

// 타임아웃 (ms)
#define I2C_TIMEOUT 100

// 함수 프로토타입
HAL_StatusTypeDef zsc31014_start_cm(void);
HAL_StatusTypeDef zsc31014_start_nom(void);
HAL_StatusTypeDef zsc31014_read_eeprom(uint8_t word_addr, uint16_t *data);
HAL_StatusTypeDef zsc31014_write_eeprom(uint8_t word_addr, uint16_t data);
HAL_StatusTypeDef zsc31014_read_all_eeprom(uint16_t *data_array);
HAL_StatusTypeDef zsc31014_write_all_eeprom(uint16_t *data_array);

/**
 * @brief Command Mode 진입
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_start_cm(void) {
    uint8_t tx_data[3] = {CMD_START_CM, 0x00, 0x00}; // Start_CM 명령 + 데이터 0x0000
    HAL_StatusTypeDef status;

    status = HAL_I2C_Master_Transmit(&hi2c1, ZSC31014_I2C_ADDR, tx_data, 3, I2C_TIMEOUT);
    if (status != HAL_OK) {
        printf("Start_CM 실패: %d\n", status);
        return status;
    }

    // 명령 완료 대기 (데이터시트: 10us, 페이지 37)
    HAL_Delay(1);
    return HAL_OK;
}

/**
 * @brief Normal Operation Mode 복귀 및 EEPROM 서명 업데이트
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_start_nom(void) {
    uint8_t tx_data[3] = {CMD_START_NOM, 0x00, 0x00}; // Start_NOM 명령 + 데이터 0x0000
    HAL_StatusTypeDef status;

    status = HAL_I2C_Master_Transmit(&hi2c1, ZSC31014_I2C_ADDR, tx_data, 3, I2C_TIMEOUT);
    if (status != HAL_OK) {
        printf("Start_NOM 실패: %d\n", status);
        return status;
    }

    // 서명 업데이트 포함 최대 15ms 대기 (데이터시트 페이지 37)
    HAL_Delay(15);
    return HAL_OK;
}

/**
 * @brief 특정 EEPROM 워드 읽기
 * @param word_addr 워드 주소 (0x00 ~ 0x13)
 * @param data 읽은 16비트 데이터 저장 포인터
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_read_eeprom(uint8_t word_addr, uint16_t *data) {
   
    HAL_StatusTypeDef status;

    // Command Mode 진입
    status = zsc31014_start_cm();
    if (status != HAL_OK) {
        printf("Command Mode 진입 실패\n");
        return status;
    }
   
   if (word_addr > 0x13) {
        printf("잘못된 워드 주소: 0x%02X\n", word_addr);
        return HAL_ERROR;
    }

    HAL_StatusTypeDef status;
    uint8_t tx_data[3] = {CMD_EEPROM_READ_BASE + word_addr, 0x00, 0x00}; // 읽기 명령
    uint8_t rx_data[3];

    // 읽기 명령 전송
    status = HAL_I2C_Master_Transmit(&hi2c1, ZSC31014_I2C_ADDR, tx_data, 3, I2C_TIMEOUT);
    if (status != HAL_OK) {
        printf("EEPROM 읽기 명령 전송 실패 (워드 0x%02X): %d\n", word_addr, status);
        return status;
    }

    // 데이터 수신 (5AHEX + 16비트 데이터)
    status = HAL_I2C_Master_Receive(&hi2c1, ZSC31014_I2C_ADDR, rx_data, 3, I2C_TIMEOUT);
    if (status != HAL_OK) {
        printf("EEPROM 데이터 수신 실패 (워드 0x%02X): %d\n", word_addr, status);
        return status;
    }

    // 첫 바이트가 0x5A인지 확인
    if (rx_data[0] != 0x5A) {
        printf("EEPROM 읽기 응답 오류 (워드 0x%02X): 0x%02X\n", word_addr, rx_data[0]);
        return HAL_ERROR;
    }

    // 16비트 데이터 조합
    *data = (rx_data[1] << 8) | rx_data[2];
    
    // Normal Operation Mode 복귀
    status = zsc31014_start_nom();
    if (status != HAL_OK) {
        printf("Normal Operation Mode 복귀 실패\n");
        return status;
    }
    return HAL_OK;
}

/**
 * @brief 특정 EEPROM 워드 쓰기
 * @param word_addr 워드 주소 (0x00 ~ 0x13)
 * @param data 쓸 16비트 데이터
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_write_eeprom(uint8_t word_addr, uint16_t data) {
    
    HAL_StatusTypeDef status;

    // Command Mode 진입
    status = zsc31014_start_cm();
    if (status != HAL_OK) {
        printf("Command Mode 진입 실패\n");
        return status;
    }
    if (word_addr > 0x13) {
        printf("잘못된 워드 주소: 0x%02X\n", word_addr);
        return HAL_ERROR;
    }

    // T_Config(0x10), Osc_Trim(0x11)은 공장 설정 유지 경고
    if (word_addr == 0x10 || word_addr == 0x11) {
        printf("경고: 워드 0x%02X는 공장 설정 유지 권장\n", word_addr);
    }

    HAL_StatusTypeDef status;
    uint8_t tx_data[3] = {
        CMD_EEPROM_WRITE_BASE + word_addr, // 쓰기 명령
        (data >> 8) & 0xFF,               // 상위 바이트
        data & 0xFF                       // 하위 바이트
    };

    status = HAL_I2C_Master_Transmit(&hi2c1, ZSC31014_I2C_ADDR, tx_data, 3, I2C_TIMEOUT);
    if (status != HAL_OK) {
        printf("EEPROM 쓰기 실패 (워드 0x%02X): %d\n", word_addr, status);
        return status;
    }

    // 쓰기 완료 대기 (데이터시트: 10ms, 페이지 37)
    HAL_Delay(10);
    
    // Normal Operation Mode 복귀
    status = zsc31014_start_nom();
    if (status != HAL_OK) {
        printf("Normal Operation Mode 복귀 실패\n");
        return status;
    }
    return HAL_OK;
}

/**
 * @brief 전체 EEPROM 읽기 (0x00 ~ 0x13)
 * @param data_array 20개 워드(16비트)를 저장할 배열
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_read_all_eeprom(uint16_t *data_array) {
    HAL_StatusTypeDef status;

    // Command Mode 진입
    status = zsc31014_start_cm();
    if (status != HAL_OK) {
        printf("Command Mode 진입 실패\n");
        return status;
    }

    // 워드 0x00 ~ 0x13 읽기
    for (uint8_t word_addr = 0x00; word_addr <= 0x13; word_addr++) {
        status = zsc31014_read_eeprom(word_addr, &data_array[word_addr]);
        if (status != HAL_OK) {
            printf("EEPROM 읽기 실패 (워드 0x%02X)\n", word_addr);
            return status;
        }
        printf("워드 0x%02X: 0x%04X\n", word_addr, data_array[word_addr]);
    }

    // Normal Operation Mode 복귀
    status = zsc31014_start_nom();
    if (status != HAL_OK) {
        printf("Normal Operation Mode 복귀 실패\n");
        return status;
    }

    return HAL_OK;
}

/**
 * @brief 전체 EEPROM 쓰기 (0x00 ~ 0x13)
 * @param data_array 쓸 20개 워드(16비트) 데이터 배열
 * @retval HAL_OK 성공, 그 외 에러
 */
HAL_StatusTypeDef zsc31014_write_all_eeprom(uint16_t *data_array) {
    HAL_StatusTypeDef status;

    // Command Mode 진입
    status = zsc31014_start_cm();
    if (status != HAL_OK) {
        printf("Command Mode 진입 실패\n");
        return status;
    }

    // 워드 0x00 ~ 0x13 쓰기
    for (uint8_t word_addr = 0x00; word_addr <= 0x13; word_addr++) {
        status = zsc31014_write_eeprom(word_addr, data_array[word_addr]);
        if (status != HAL_OK) {
            printf("EEPROM 쓰기 실패 (워드 0x%02X)\n", word_addr);
            return status;
        }
        printf("워드 0x%02X에 0x%04X 쓰기 완료\n", word_addr, data_array[word_addr]);
    }

    // Normal Operation Mode 복귀 및 서명 업데이트
    status = zsc31014_start_nom();
    if (status != HAL_OK) {
        printf("Normal Operation Mode 복귀 실패\n");
        return status;
    }

    return HAL_OK;
}

/**
 * @brief 메인 함수 예시 (사용 예시)
 */
void zsc31014_example(void) {
    HAL_StatusTypeDef status;
    uint16_t eeprom_data[20]; // 0x00 ~ 0x13 워드 저장 배열

    // 전체 EEPROM 읽기
    printf("EEPROM 전체 읽기 시작\n");
    status = zsc31014_read_all_eeprom(eeprom_data);
    if (status != HAL_OK) {
        printf("EEPROM 전체 읽기 실패\n");
        return;
    }

    // 특정 워드 읽기 (예: 워드 0x01)
    uint16_t single_data;
    printf("워드 0x01 읽기 시작\n");
    status = zsc31014_read_eeprom(0x01, &single_data);
    if (status == HAL_OK) {
        printf("워드 0x01: 0x%04X\n", single_data);
    } else {
        printf("워드 0x01 읽기 실패\n");
    }

    // 특정 워드 쓰기 (예: 워드 0x01에 0x0000 쓰기)
    printf("워드 0x01에 0x0000 쓰기 시작\n");
    status = zsc31014_write_eeprom(0x01, 0x0000);
    if (status == HAL_OK) {
        printf("워드 0x01 쓰기 완료\n");
    } else {
        printf("워드 0x01 쓰기 실패\n");
    }

    // 전체 EEPROM 쓰기 예시 (샘플 데이터)
    uint16_t sample_data[20];
    memset(sample_data, 0, sizeof(sample_data)); // 0으로 초기화
    sample_data[0x01] = 0x0000; // 예: 워드 0x01 설정 (I2C, 1MHz, 8비트 온도 등)
    sample_data[0x02] = 0x0280; // 예: 슬레이브 주소 0x28
    // 워드 0x10, 0x11은 공장 설정 유지 권장
    printf("EEPROM 전체 쓰기 시작\n");
    status = zsc31014_write_all_eeprom(sample_data);
    if (status == HAL_OK) {
        printf("EEPROM 전체 쓰기 완료\n");
    } else {
        printf("EEPROM 전체 쓰기 실패\n");
    }
}

코드 설명

1. I²C 설정:
   • ZSC31014_I2C_ADDR는 7비트 주소 0x28을 왼쪽으로 1비트 시프트하여 HAL 라이브러리 형식에 맞춤.
   • STM32CubeMX에서 I²C1을 100kHz로 설정했다고 가정.
   • hi2c1은 STM32CubeMX에서 생성된 I²C 핸들러.
2. 함수:
   • zsc31014_start_cm(): Command Mode 진입 (A0HEX), POR 후 6ms 이내 호출 필요.
   • zsc31014_start_nom(): Normal Operation Mode 복귀 및 서명 업데이트 (80HEX).
   • zsc31014_read_eeprom(): 특정 워드(0x00 ~ 0x13) 읽기, 명령 코드 00HEX ~ 13HEX.
   • zsc31014_write_eeprom(): 특정 워드 쓰기, 명령 코드 40HEX ~ 53HEX.
   • zsc31014_read_all_eeprom(): 전체 워드(0x00 ~ 0x13) 읽기, 결과를 배열에 저장.
   • zsc31014_write_all_eeprom(): 전체 워드에 데이터 쓰기, 공장 설정 워드(0x10, 0x11)에 대한 경고 포함.
   • zsc31014_example(): 사용 예시로 전체 읽기/쓰기, 특정 워드 읽기/쓰기 포함.
3. 타이밍:
   • Start_CM: 10μs 대기.
   • Start_NOM: 최대 15ms 대기 (서명 업데이트 포함).
   • EEPROM 읽기: 100μs 대기.
   • EEPROM 쓰기: 10ms 대기 (페이지 37, Table 3.6).
   • HAL_Delay를 사용하여 충분한 대기 시간 확보.
4. 에러 처리:
   • 각 함수는 HAL 상태를 반환하며, 에러 시 콘솔에 메시지 출력 (디버깅용 printf 가정).
   • 잘못된 워드 주소(0x13 초과) 또는 공장 설정 워드(0x10, 0x11) 쓰기 시 경고.
5. 사용 예시:
   • zsc31014_example()는 전체 EEPROM 읽기, 특정 워드(0x01) 읽기/쓰기, 전체 쓰기를 테스트.
   • 샘플 데이터는 워드 0x01 (예: I²C, 1MHz, 8비트 온도)과 0x02 (슬레이브 주소 0x28)만 설정, 나머지는 0으로 초기화.

---

사용 방법

1. STM32CubeMX 설정:
   • I²C1 활성화, 속도 100kHz, 주소 7비트 모드.
   • GPIO 설정: SCL (예: PB6), SDA (예: PB7), 풀업 저항(1kΩ~10kΩ, 데이터시트 페이지 6).
   • UART 디버깅용 설정(printf 출력용, 선택 사항).
2. 코드 통합:
   • 위 코드를 STM32 프로젝트의 main.c 또는 별도의 소스 파일에 추가.
   • hi2c1 핸들러가 STM32CubeMX에서 초기화되었다고 가정.
   • main()에서 zsc31014_example() 호출.
3. 하드웨어 연결:
   • ZSC31014의 VDD: 2.7V~5.5V (예: 3.3V, STM32L432KC와 동일).
   • VSS: GND.
   • SCL: PB6, SDA: PB7 (STM32 I²C1 핀).
   • VDD와 GND 사이에 100nF~470nF 커패시터 연결(페이지 6).
   • I²C 라인에 1kΩ 풀업 저항 연결.
4. 빌드 및 테스트:
   • STM32CubeIDE에서 빌드 및 플래시.
   • 시리얼 터미널(예: PuTTY)로 디버그 출력 확인.
   • zsc31014_example() 호출로 EEPROM 읽기/쓰기 테스트.

---

주의사항

• POR 후 6ms: Start_CM은 전원 켜짐 후 6ms 이내 실행(페이지 37).
• 공장 설정 워드: T_Config(0x10), Osc_Trim(0x11)은 변경 시 온도 정확도(±2.5K) 손실 가능(페이지 41).
• EEPROM 서명: 쓰기 후 Start_NOM 호출 필수,진단 오류(S[1:0] = 11, 페이지 24).
• I²C 주소: 워드 02HEX 비트 [12:10]이 011이면 주소 고정(페이지 40).
• 디버깅: HAL 에러 코드와 ZSC31014 상태를 확인하여 문제 진단.
• 샘플 데이터: 전체 쓰기 시 sample_data 배열은 응용에 맞게 수정 필요(예: Gain_B, Offset_B 등).