HALI2CMem_Read bana açıkla
- User
HAL_I2C_Mem_Read bana açıkla
- Assistant
HAL_I2C_Mem_Readfonksiyonu, STM32 mikrodenetleyicilerinde I2C (Inter-Integrated Circuit) iletişimini kullanarak, belirli bir I2C cihazının hafızasından veri okunmasını sağlar. Bu fonksiyon, HAL (Hardware Abstraction Layer) kütüphanesi içinde yer alır ve kullanımı oldukça kolaydır. Fonksiyonun prototipi ve parametreleri şu şekildedir:HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);Parametreler:
-
I2C_HandleTypeDef *hi2c: I2C işlemi sırasında kullanılacak olan I2C'nin yapılandırma ve durum bilgilerini içeren yapı işaretçisi. Genelliklehi2c1veyahi2c2gibi isimlendirilir ve I2C'nin konfigürasyonuMX_I2C1_Init()gibi fonksiyonlarla yapılır. -
uint16_t DevAddress: Haberleşme sağlanacak I2C cihazının (slav cihaz) 7 veya 10 bitlik adresi. -
uint16_t MemAddress: Okunmak istenen verinin bulunduğu hafıza adresi. -
uint16_t MemAddSize: Hafıza adresinin uzunluğu. GenellikleI2C_MEMADD_SIZE_8BITveyaI2C_MEMADD_SIZE_16BITdeğeri alır. -
uint8_t *pData: Okunacak verinin depolanacağı veri tamponunun adresi. -
uint16_t Size: Okunacak veri miktarı (bayt cinsinden). -
uint32_t Timeout: İşlemin zaman aşımı değeri (milisaniye cinsinden). Bu süre içinde işlem tamamlanmazsa fonksiyon hata döner.
Dönüş Değeri: Fonksiyon,
HAL_StatusTypeDeftüründe bir değer döner. Bu tür aşağıdaki değerleri alabilir:HAL_OK: İşlem başarılı.HAL_ERROR: İşlem hatası.HAL_BUSY: I2C hattı meşgul.HAL_TIMEOUT: İşlem zaman aşımına uğradı.
Örnek Kullanımı:
Aşağıda
HAL_I2C_Mem_Readfonksiyonunun örnek bir kullanımı verilmiştir. Bu örnekte, bir I2C EEPROM'dan veri okunması gösterilmektedir.#define EEPROM_I2C_ADDR 0xA0 // Cihazın I2C adresi #define EEPROM_MEM_ADDR 0x0000 // EEPROM hafıza adresi uint8_t data[16]; // Okunan verinin depolanacağı tampon HAL_StatusTypeDef ret; ret = HAL_I2C_Mem_Read(&hi2c1, EEPROM_I2C_ADDR, EEPROM_MEM_ADDR, I2C_MEMADD_SIZE_16BIT, data, sizeof(data), 1000); if(ret == HAL_OK) { // Veri başarıyla okundu } else { // Hata durumuna göre işlem yap }Yukarıdaki örnekte,
hi2c1isimli I2C hattından,0xA0adresli I2C cihazının0x0000hafıza adresinden, 16 baytlık veri okunupdatatamponuna yazılmaktadır.Bu bilgiler ışığında,
HAL_I2C_Mem_Readfonksiyonunu kullanarak I2C hafıza okuma işlemlerini kolayca gerçekleştirebilirsiniz. -