MPAE-19435 project working, readme and main-meta updated

Author: Glen-Nilsen

.main-meta/main.json

@@ -4,8 +4,8 @@
     "content": {
         "metaDataVersion": "1.3.0",
         "name": "com.microchip.mcu8.mplabx.project.avr128db48-i2c-io-expander1-leds-polled-printf",
-        "version": " ",
-        "displayName": "",
+        "version": "1.0.0",
+        "displayName": "avr128db48-i2c-io-expander1-leds-polled-printf",
         "projectName": "avr128db48-i2c-io-expander1-leds-polled-printf",
         "shortDescription": "LED chaser increments binary on 6 LEDs every 100 ms. When all on, toggles 8 LEDs every sec. Polled with Delay driver, shows hex/binary of I/O expander pins via UART printf.",
         "ide": {
@@ -18,13 +18,13 @@
                 "semverRange": "^3.0.0"
             }
         ],
-        "dfp": {
-            "name": "",
-            "semverRange": ""
+         "dfp": {
+            "name": "PIC18F-Q_DFP",
+            "semverRange": "^3.0.0"
         },
         "configurator": {
-            "name": "",
-            "semverRange": ""
+            "name": "MCC",
+            "semverRange": "^5.6.2"
         },
         "device": {
             "metaDataVersion": "1.0.0",
@@ -37,8 +37,23 @@
             }
         },
         "author": "Glen Nilsen",
-        "peripherals": [],
-        "keywords": [],
+        "peripherals": [
+            "I2C",
+            "GPIO",
+            "UART"
+        ],
+        "keywords": [
+            "Data Visualizer",
+            "MPLAB Data Visualizer",
+            "I2C",
+            "UART",
+            "Getting Started",
+            "Melody",
+            "MCC Melody",
+            "Curiosity Nano Explorer",
+            "Example Components",
+            "MCC Melody Example Components"
+        ],
         "additionalData": {
             "longDescription": {
                 "metaDataVersion": "1.0.0",

README.md

@@ -10,53 +10,59 @@
 
 # AVR128DB48 I2C_Host Example Component for CNano Explorer: I/O Expander 1 LEDs (Polled, Printf)
 
-The following is the output for this example. 
-Notice the delta 103 ms in the B and the 1.21 s in the C columns, respectively of the time plot. The difference from 100 ms, is simply due to the positioning of the cursor. 
+The [I<sup>2</sup>C Host IO Expander 1 - LEDs Example](https://onlinedocs.microchip.com/v2/keyword-lookup?keyword=I2C.HOST.EX.RUNNING.I2C.HOST.IOEXPANDER1.LEDS&version=latest&redirect=true "I2C Host IO Expander 1 - LEDs Example"
+), of the [MCC Melody I<sup>2</sup>C Example Component (for the Curiosity Nano Explorer)](https://onlinedocs.microchip.com/v2/keyword-lookup?keyword=I2C.HOST.EXAMPLE.COMPONENT&version=latest&redirect=true "MCC Melody I<sup>2</sup>C Example Component for the Curiosity Nano Explorer"
+), is used here in the Polled implementation, with the Printf visualization. 
 
-![alt text](images/avr128db48-i2c-io-expander1-leds-polled-printf_avrDB.png)
+![alt text](images\avr128db48-i2c-io-expander1-leds-polled-printf_avrDB_intro.png)
 
-The MCC Melody configuration is as shown in the following image. 
+The example implements an LED chaser, incrementing the binary number on the lower six LEDs every 100 ms. Once the six active-low LEDs are all on, the pattern changes to toggle all eight LEDs every second.
 
-![alt text](images/avr128db48-i2c-io-expander1-leds-polled-printf_avrDB_configuration.png)
+The polled implementation simply uses a delay, first of 100 ms then the delay period is changed to 1s once the LED chaser is finished.  The hex and binary values of the I/O expander pins are displayed as a printf message over the Universal Asynchronous Receiver and Transmitter (UART).
 
+## Operation
+When running the application using the [MPLAB® Data Visualizer](https://www.microchip.com/en-us/tools-resources/debug/mplab-data-visualizer "MPLAB® Data Visualizer"), you should see something similar to the following. 
 
+![alt text](images/avr128db48-i2c-io-expander1-leds-polled-printf_avrDB.png)
+**Note:** the delta 103 ms in the B and the 1.21 s in the C columns, respectively of the time plot. The difference from 100 ms, is simply due to the positioning of the cursor. 
 
-<!-- This is where the introduction to the example goes, including mentioning the peripherals used -->
+## Setup
+The image below outlines the complete MPLAB Code Configurator (MCC) Melody configuration, including all the selected tasks implemented in this example, as seen in the MCC Melody Builder.
 
-## Related Documentation
+![alt text](images/avr128db48-i2c-io-expander1-leds-polled-printf_avrDB_configuration.png)
+![alt text](images/avr128db48-i2c-io-expander1-leds-polled-printf_avrDB_configuration_pins.png)
 
-<!-- Any information about an application note or tech brief can be linked here. Use unbreakable links!
-     In addition a link to the device family landing page and relevant peripheral pages as well:
-     - [AN3381 - Brushless DC Fan Speed Control Using Temperature Input and Tachometer Feedback](https://microchip.com/00003381/)
-     - [PIC18F-Q10 Family Product Page](https://www.microchip.com/design-centers/8-bit/pic-mcus/device-selection/pic18f-q10-product-family) -->
 
-## Software Used
 
-<!-- All software used in this example must be listed here. Use unbreakable links!
-     - MPLAB® X IDE 5.30 or newer [(microchip.com/mplab/mplab-x-ide)](http://www.microchip.com/mplab/mplab-x-ide)
-     - MPLAB® XC8 2.10 or a newer compiler [(microchip.com/mplab/compilers)](http://www.microchip.com/mplab/compilers)
-     - MPLAB® Code Configurator (MCC) 3.95.0 or newer [(microchip.com/mplab/mplab-code-configurator)](https://www.microchip.com/mplab/mplab-code-configurator)
-     - MPLAB® Code Configurator (MCC) Device Libraries PIC10 / PIC12 / PIC16 / PIC18 MCUs [(microchip.com/mplab/mplab-code-configurator)](https://www.microchip.com/mplab/mplab-code-configurator)
-     - Microchip PIC18F-Q Series Device Support (1.4.109) or newer [(packs.download.microchip.com/)](https://packs.download.microchip.com/) -->
+## MCC Melody Example Components
+Example Components are a tight integration of learning material directly into MCC. This allows users to conveniently place the configuration instructions side-by-side to the components they are configuring. For more information, refer to the [MCC Melody Example Components](https://onlinedocs.microchip.com/v2/keyword-lookup?keyword=MCC.MELODY.EXAMPLES&version=latest&redirect=true) introduction. 
 
-- MPLAB® X IDE 6.25.0 or newer [(MPLAB® X IDE 6.25)](https://www.microchip.com/en-us/development-tools-tools-and-software/mplab-x-ide)
-- MPLAB® XC8 3.0.0 or newer compiler [(MPLAB® XC8 3.0)](https://www.microchip.com/en-us/tools-resources/develop/mplab-xc-compilers/xc8)
 
-## Hardware Used
+## Related Documentation
 
-<!-- All hardware used in this example must be listed here. Use unbreakable links!
-     - PIC18F47Q10 Curiosity Nano [(DM182029)](https://www.microchip.com/Developmenttools/ProductDetails/DM182029)
-     - Curiosity Nano Base for Click boards™ [(AC164162)](https://www.microchip.com/Developmenttools/ProductDetails/AC164162)
-     - POT Click board™ [(MIKROE-3402)](https://www.mikroe.com/pot-click) -->
+- [MCC Melody I<sup>2</sup>C Example Component (for the Curiosity Nano Explorer)](https://onlinedocs.microchip.com/v2/keyword-lookup?keyword=I2C.HOST.EXAMPLE.COMPONENT&version=latest&redirect=true "MCC Melody I<sup>2</sup>C Example Component for the Curiosity Nano Explorer")
+- [MCC Melody Design Patterns for Control Flow](https://onlinedocs.microchip.com/g/GUID-7CE1AEE9-2487-4E7B-B26B-93A577BA154E "MCC Melody Design Patterns for Control Flow")
 
-## Setup
+- [Curiosity Nano Explorer User Guide](https://ww1.microchip.com/downloads/aemDocuments/documents/MCU08/ProductDocuments/UserGuides/AVR128DB48-Curiosity-Nano-HW-UserGuide-DS40002186B.pdf "Curiosity Nano Explorer Users Guide")
 
-<!-- Explain how to connect hardware and set up software. Depending on complexity, step-by-step instructions and/or tables and/or images can be used -->
+- [AVR128DB48 Data Sheet](https://ww1.microchip.com/downloads/en/DeviceDoc/AVR128DB28-32-48-64-DataSheet-DS40002247A.pdf "AVR128DB48 Data Sheet")
 
-## Operation
+## Software Used
+- [MPLAB® X IDE](https://www.microchip.com/en-us/development-tools-tools-and-software/mplab-x-ide) v6.25 or newer 
+- [MPLAB® XC8](https://www.microchip.com/en-us/tools-resources/develop/mplab-xc-compilers/xc8) v3.00 or newer
+
+- [MPLAB® Code Configurator](https://www.microchip.com/en-us/tools-resources/configure/mplab-code-configurator) (MCC) Plug-in Version v5.6.2 or newer (*Tools>Plugins>Installed*, search: "MCC")
+- [MPLAB® Data Visualizer](https://www.microchip.com/en-us/tools-resources/debug/mplab-data-visualizer) Plug-in Version v1.4.1926 or newer (*Tools>Plugins>Installed*, search: "Data Visualizer")
+- MCC Melody I2C_Host Example Component for the Curiosity Nano Explorer 1.0.0 or newer
+- MCC Core v5.8.2 or newer 
+- Single Page Application (SPA) Host v1.0.0 or newer
+- MCC Melody Core v2.9.1 or newer
 
-<!-- Explain how to operate the example. Depending on complexity, step-by-step instructions and/or tables and/or images can be used -->
+Open the MCC Content Manager ![CM_icon](images/Icon-MPLAB-CM24.png) to verify the MCC Core and MCC Melody Core versions. 
 
-## Summary
+![alt text](images/MCC_Core_ContentLibrary_Versions_SPA.png) 
+
+## Hardware Used
+- AVR128DB48 Curiosity Nano [(EV35L43A)](https://www.microchip.com/en-us/development-tool/EV35L43A)
+- Curiosity Nano Explorer [(EV58G97A)](https://www.microchip.com/en-us/development-tool/EV58G97A)
 
-<!-- Summarize what the example has shown -->

avr128db48-i2c-io-expander1-leds-polled-printf.X/avr128db48-i2c-io-expander1-leds-polled-printf.mc3

@@ -25,7 +25,7 @@
  * 
  * @ingroup i2c_host example
  * 
- * @version I2C_HOST EXAMPLE Example Version 1.0.0
+ * @version I2C_HOST EXAMPLE Example Version 1.0.1
  *
  * @brief Generated file for
  *        Example:           2. I2C IO Expander 1 - LEDs 
@@ -40,91 +40,99 @@
 //        MCP23008 register addresses are in Table 1-2 (page 5) of the data sheet
 //        The Curiosity Nano Explorer (EV58G97A) has 2 x MCP23008 IO Expanders
 
-#define MCP23008_1_I2C_ADDRESS      ((uint8_t)0x25)
+#define MCP23008_1_I2C_ADDRESS  ((uint8_t)0x25)
 #define MCP23008_REG_ADDR_IODIR     0x00
 #define MCP23008_REG_ADDR_GPIO      0x09
 #define PINS_DIGITAL_OUTPUT         0x00
 #define PINS_DIGITAL_HIGH           0xFF
+#define PINS_DIGITAL_LOW            0x00
 #define DATALENGTH                  2
+#define I2C_ERROR_NONE              0
 
 extern void DELAY_milliseconds(uint16_t milliseconds);
+static uint8_t MCP23008_Write(uint8_t address, uint8_t reg, uint8_t data);
+static void to_binary(uint8_t num, char *str); 
+static uint16_t led_row_counter(void);
 
-uint8_t errorState = I2C_ERROR_NONE;
-uint8_t *data;
-uint8_t *data_length;
-uint8_t pins = 0; 
-char binaryStr[9]; // 8 bits + null terminator
+static i2c_host_error_t errorState = I2C_ERROR_NONE;
+static uint8_t *data;
+static uint8_t *data_length;
+static uint8_t pins = 0; 
+static char binaryStr[9]; // 8 bits + null terminator
 
-uint8_t MCP23008_Write(uint8_t address, uint8_t reg, uint8_t data)
+static uint8_t MCP23008_Write(uint8_t address, uint8_t reg, uint8_t data)
 {
-    uint8_t errorState = I2C_ERROR_NONE;
     size_t txLength = 2;
-    uint8_t txBuffer[2] = {};
+    uint8_t txBuffer[2] = {0};
 
     txBuffer[0] = reg;
     txBuffer[1] = data;
 
-    uint8_t waitCounter = 100;
     if(I2C_Host.Write(MCP23008_1_I2C_ADDRESS, txBuffer, txLength))
     {   
-        while (I2C_Host.IsBusy() && waitCounter--) 
+        uint8_t waitCounter = 100;
+        while(!I2C_Host.IsBusy())
+        {
+            //Wait here until I2C bus can start transmitting
+        }
+        while (I2C_Host.IsBusy() && (waitCounter > 0U)) 
         {
             I2C_Host.Tasks();
+            waitCounter--;             
         }
     }
 
     errorState = I2C_Host.ErrorGet();
     return errorState;
 }
 
-// Function to convert a number to a binary string
-void to_binary(uint8_t num, char *str) 
+static void to_binary(uint8_t num, char *str) 
 {
-    for (int i = 7; i >= 0; i--) 
-    {
-        str[7 - i] = (num & (1 << i)) ? '1' : '0';
+    for (uint8_t i = 0U; i < 8U; i++) {
+        str[7U - i] = ((num & (uint8_t)(1U << (7U - i))) != 0U) ? '1' : '0';
     }
     str[8] = '\0'; // Null-terminate the string
 }
 
-uint16_t led_row_counter(void)
+static uint16_t led_row_counter(void)
 {
-    for (pins = 0; pins < 64; pins++)
+    for (pins = 0; pins < 64U; pins++)
     {
         // Invert the pins, since using pins 8 to 3, which are active low 
         uint8_t pins_inverted = ~(pins << 2); 
         errorState = MCP23008_Write(MCP23008_1_I2C_ADDRESS, MCP23008_REG_ADDR_GPIO, pins_inverted); 
 
         to_binary(pins_inverted, binaryStr);
-        printf("LED state: 0x%02X 0b%s\n", pins_inverted, binaryStr);
+        (int) printf("LED state: 0x%02X 0b%s\n", pins_inverted, binaryStr);
         IO_LED_Toggle();
         IO_Debug_Toggle(); 
         DELAY_milliseconds(100);
     }
-    printf("\r\n");
+    (int) printf("\r\n");
     return errorState;
 }
 
 int main(void)
 {
     DELAY_milliseconds(200); // Prevent program running when programming
     SYSTEM_Initialize();
-    printf("Example: 2. I2C IO Expander 1 - LEDs, Implementation: Polled, Visualization: Printf\r\n");
-    printf("Note: LEDs are assumed to be active LOW.\r\n");
+    (int) printf("Example: 2. I2C IO Expander 1 - LEDs, Implementation: Polled, Visualization: Printf\r\n");
+    (int) printf("MCU Device family: AVR \r\n\r\n");
+    (int) printf("Note: LEDs are assumed to be active LOW.\r\n");
 
     errorState = MCP23008_Write(MCP23008_1_I2C_ADDRESS, MCP23008_REG_ADDR_IODIR, PINS_DIGITAL_OUTPUT);
 
     errorState = led_row_counter(); 
     DELAY_milliseconds(1000);
 
-    pins = 0xFF; // Turn off active LOW LEDs
+    pins = (uint8_t) 0xFF; // Turn off active LOW LEDs
     errorState = MCP23008_Write(MCP23008_1_I2C_ADDRESS, MCP23008_REG_ADDR_GPIO, pins);    
 
     while(1)
     {
         errorState = MCP23008_Write(MCP23008_1_I2C_ADDRESS, MCP23008_REG_ADDR_GPIO, pins); 
         to_binary(pins, binaryStr);
-        printf("LED state: 0x%02X 0b%s \r\n", pins, binaryStr);
+        (int) printf("LED state: 0x%02X 0b%s \r\n", pins, binaryStr);
         IO_LED_Toggle();
         IO_Debug_Toggle(); 
         DELAY_milliseconds(1000);

avr128db48-i2c-io-expander1-leds-polled-printf.X/main.c

@@ -2,31 +2,39 @@
 
 manifest_file_version: 1.0.0
 project: avr128db48-i2c-io-expander1-leds-polled-printf
-creation_date: 2025-04-10T13:17:13.120+02:00[Europe/Berlin]
+creation_date: 2025-10-20T16:05:47.927+02:00[Europe/Berlin]
 operating_system: Windows 11
 mcc_mode: IDE
 mcc_mode_version: v6.25
 device_name: AVR128DB48
 compiler: XC8 3.00
-mcc_version: 5.5.2
-mcc_core_version: 5.7.1
-content_manager_version: 5.0.1
+mcc_version: 5.6.2
+mcc_core_version: 5.8.2
+content_manager_version: 6.0.3-rc.a
 is_mcc_offline: false
-is_using_prerelease_versions: true
-mcc_content_registries: https://registry.npmjs.org/,https://artifacts.microchip.com/artifactory/api/npm/npm/
-device_library: {library_class: com.microchip.mcc.melody.Library, name: Melody, version: 2.9.0-feat.24}
-packs: {name: AVR-Dx_DFP, version: 2.7.321}
+is_using_prerelease_versions: false
+mcc_content_registries: https://registry.npmjs.org/
+device_library: {library_class: com.microchip.mcc.melody.Library, name: Melody, version: 2.10.0}
+packs: {name: N/A, version: N/A}
 modules:
-- {name: '@mchp-mcc/avr-8bit', type: MELODY, version: 4.13.1-dev.4}
-- {name: '@mchp-mcc/avr8-configuration-bits-v1', type: MELODY, version: 4.3.0}
-- {name: '@mchp-mcc/avr8-pin-manager', type: MELODY, version: 4.6.1}
-- {name: '@mchp-mcc/delay-blocking-driver', type: MELODY, version: 3.2.0}
-- {name: '@mchp-mcc/example-i2c-host', type: MELODY, version: 1.0.0}
-- {name: '@mchp-mcc/i2c-host-driver', type: MELODY, version: 1.1.0-dev.1}
-- {name: '@mchp-mcc/main-manager', type: MELODY, version: 3.1.2}
-- {name: '@mchp-mcc/pin-content-processor', type: MELODY, version: 3.9.1-feat.6}
-- {name: '@mchp-mcc/scf-avr8-clkctrl-v3', type: MELODY, version: 2.1.0-dev.1}
-- {name: '@mchp-mcc/scf-avr8-interrupt-v1', type: MELODY, version: 5.0.13-dev.1}
 - {name: '@mchp-mcc/scf-avr8-twi-v1', type: MELODY, version: 8.2.0}
-- {name: '@mchp-mcc/scf-avr8-usart-v1', type: MELODY, version: 10.2.1}
+- {name: '@mchp-mcc/avr8-pin-manager', type: MELODY, version: 4.6.2}
+- {name: '@mchp-mcc/scf-avr8-clkctrl-v3', type: MELODY, version: 2.0.10}
+- {name: '@mchp-mcc/delay-blocking-driver', type: MELODY, version: 3.2.0}
+- {name: '@mchp-mcc/scf-avr8-interrupt-v1', type: MELODY, version: 5.0.12}
+- {name: '@mchp-mcc/i2c-host-driver', type: MELODY, version: 1.0.5}
+- {name: '@mchp-mcc/pin-content-processor', type: MELODY, version: 3.11.0}
 - {name: '@mchp-mcc/uart-driver', type: MELODY, version: 1.10.2}
+- {name: '@mchp-mcc/avr8-configuration-bits-v1', type: MELODY, version: 4.3.0}
+- {name: '@mchp-mcc/scf-avr8-usart-v1', type: MELODY, version: 10.3.1}
+- {name: '@mchp-mcc/avr-8bit', type: MELODY, version: 4.14.2}
+- {name: '@mchp-mcc/example-i2c-host', type: MELODY, version: 1.0.1}
+- {name: '@mchp-mcc/main-manager', type: MELODY, version: 3.1.2}
+- {name: '@mchp-mcc/example-i2c-host', type: MELODY, version: 1.0.1}
+- {name: '@mchp-mcc/scf-avr8-interrupt-v1', type: MELODY, version: 5.0.12}
+- {name: '@mchp-mcc/avr8-pin-manager', type: MELODY, version: 4.6.2}
+- {name: '@mchp-mcc/scf-avr8-usart-v1', type: MELODY, version: 10.3.1}
+- {name: '@mchp-mcc/pin-content-processor', type: MELODY, version: 3.11.0}
+- {name: '@mchp-mcc/i2c-host-driver', type: MELODY, version: 1.0.5}
+- {name: '@mchp-mcc/scf-avr8-clkctrl-v3', type: MELODY, version: 2.0.10}
+- {name: '@mchp-mcc/avr-8bit', type: MELODY, version: 4.14.2}