MPAE-19442 Changed main to printf with error handling, working as expected

Author: Glen-Nilsen

pic18f57q43-i2c-proximity-sensor-polled-printf-errors.X/main.c

@@ -45,6 +45,7 @@ extern void DELAY_milliseconds(uint16_t milliseconds);
 
 uint8_t VCNL4200_Initialize(void);
 uint8_t VCNL4200_ProximityRead(uint16_t* proximityValue);
+const uint8_t* I2CErrorToString(uint8_t error);
 
 uint16_t proximityValue;           // proximity sensor (VCNL4200) result
 uint8_t errorState = I2C_ERROR_NONE;
@@ -67,9 +68,32 @@ uint8_t VCNL4200_ProximityRead(uint16_t* proximityValue)
         }
         *proximityValue = proximityResponse.value;
     }
+    errorState = I2C_Host.ErrorGet();
+      
+    // Error states: 
+    // 0x00 = I2C_ERROR_NONE
+    // 0x01 = I2C_ERROR_ADDR_NACK
+    // 0x02 = I2C_ERROR_DATA_NACK
+    // 0x03 = I2C_ERROR_BUS_COLLISION 
     return errorState;  
 }
 
+const uint8_t* I2CErrorToString(uint8_t error)
+{
+    switch (error)
+    {
+        case I2C_ERROR_NONE:
+            return "I2C_ERROR_NONE";
+        case I2C_ERROR_ADDR_NACK:
+            return "I2C_ERROR_ADDR_NACK";
+        case I2C_ERROR_DATA_NACK:
+            return "I2C_ERROR_DATA_NACK";
+        case I2C_ERROR_BUS_COLLISION:
+            return "I2C_ERROR_BUS_COLLISION";
+        default:
+            return "UNKNOWN_ERROR";
+    }
+}
 
 uint8_t VCNL4200_Initialize(void)
 {
@@ -92,18 +116,24 @@ uint8_t VCNL4200_Initialize(void)
             I2C_Host.Tasks();
         }
     } 
+    errorState = I2C_Host.ErrorGet();
     return errorState;  
 }
 
 int main(void)
 {
     SYSTEM_Initialize();                                                
     errorState = VCNL4200_Initialize();     // Initializes the proximity sensor (VCNL4200) over the I2C bus
+    printf("I2C proximity sensor initialize status: %d - %s\r\n", errorState, I2CErrorToString(errorState));
 
     while(1)
     {
         DELAY_milliseconds(250);
         errorState = VCNL4200_ProximityRead(&proximityValue);
+        if (errorState != I2C_ERROR_NONE) 
+        {
+            printf("The proximity sensor error: %d - %s\r\n", errorState, I2CErrorToString(errorState));
+        }
         printf("The proximity value is: %d\r\n", proximityValue); 
         IO_LED_Toggle();
         IO_Debug_Toggle();

pic18f57q43-i2c-proximity-sensor-polled-printf-errors.X/mcc-manifest-autosave.yml

@@ -2,7 +2,7 @@
 
 manifest_file_version: 1.0.0
 project: pic18f57q43-i2c-proximity-sensor-polled-printf-errors
-creation_date: 2025-04-04T11:50:39.073+02:00[Europe/Berlin]
+creation_date: 2025-04-04T12:03:18.693+02:00[Europe/Berlin]
 operating_system: Windows 11
 mcc_mode: IDE
 mcc_mode_version: v6.25

pic18f57q43-i2c-proximity-sensor-polled-printf-errors.X/mcc-manifest-generated-success.yml

@@ -2,7 +2,7 @@
 
 manifest_file_version: 1.0.0
 project: pic18f57q43-i2c-proximity-sensor-polled-printf-errors
-creation_date: 2025-04-04T11:50:39.033+02:00[Europe/Berlin]
+creation_date: 2025-04-04T12:03:18.661+02:00[Europe/Berlin]
 operating_system: Windows 11
 mcc_mode: IDE
 mcc_mode_version: v6.25

pic18f57q43-i2c-proximity-sensor-polled-printf-errors.X/mcc_generated_files/examples/I2C-Host-Example/i2c_host_example.c

@@ -30,7 +30,7 @@
  * @brief Generated file for
  *        Example:           4. I2C Proximity Sensor 
  *        Implementation:    Polled 
- *        Visualization:     Printf   
+ *        Visualization:     Printf with error handling   
  *        MCU Device family: PIC18F/18F
 */
 /* ------------------------------------------------------------------
@@ -47,6 +47,7 @@ extern void DELAY_milliseconds(uint16_t milliseconds);
 
 uint8_t VCNL4200_Initialize(void);
 uint8_t VCNL4200_ProximityRead(uint16_t* proximityValue);
+const uint8_t* I2CErrorToString(uint8_t error);
 
 uint16_t proximityValue;           // proximity sensor (VCNL4200) result
 uint8_t errorState = I2C_ERROR_NONE;
@@ -69,9 +70,32 @@ uint8_t VCNL4200_ProximityRead(uint16_t* proximityValue)
         }
         *proximityValue = proximityResponse.value;
     }
+    errorState = I2C_Host.ErrorGet();
+      
+    // Error states: 
+    // 0x00 = I2C_ERROR_NONE
+    // 0x01 = I2C_ERROR_ADDR_NACK
+    // 0x02 = I2C_ERROR_DATA_NACK
+    // 0x03 = I2C_ERROR_BUS_COLLISION 
     return errorState;  
 }
 
+const uint8_t* I2CErrorToString(uint8_t error)
+{
+    switch (error)
+    {
+        case I2C_ERROR_NONE:
+            return "I2C_ERROR_NONE";
+        case I2C_ERROR_ADDR_NACK:
+            return "I2C_ERROR_ADDR_NACK";
+        case I2C_ERROR_DATA_NACK:
+            return "I2C_ERROR_DATA_NACK";
+        case I2C_ERROR_BUS_COLLISION:
+            return "I2C_ERROR_BUS_COLLISION";
+        default:
+            return "UNKNOWN_ERROR";
+    }
+}
 
 uint8_t VCNL4200_Initialize(void)
 {
@@ -94,18 +118,24 @@ uint8_t VCNL4200_Initialize(void)
             I2C_Host.Tasks();
         }
     } 
+    errorState = I2C_Host.ErrorGet();
     return errorState;  
 }
 
 int main(void)
 {
     SYSTEM_Initialize();                                                
     errorState = VCNL4200_Initialize();     // Initializes the proximity sensor (VCNL4200) over the I2C bus
+    printf("I2C proximity sensor initialize status: %d - %s\r\n", errorState, I2CErrorToString(errorState));
     
     while(1)
     {
         DELAY_milliseconds(250);
         errorState = VCNL4200_ProximityRead(&proximityValue);
+        if (errorState != I2C_ERROR_NONE) 
+        {
+            printf("The proximity sensor error: %d - %s\r\n", errorState, I2CErrorToString(errorState));
+        }
         printf("The proximity value is: %d\r\n", proximityValue); 
         IO_LED_Toggle();
         IO_Debug_Toggle();