MPAE-19433 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-find-all-i2c-clients-on-bus-callback-printf-errors",
-        "version": " ",
-        "displayName": "",
+        "version": "1.0.0",
+        "displayName": "avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors",
         "projectName": "avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors",
         "shortDescription": "I2C write tried for all client addresses. ACK/NACK printed via UART. On completion, valid I2C addresses with ACK shown in printf message.",
         "ide": {
@@ -19,12 +19,12 @@
             }
         ],
         "dfp": {
-            "name": "",
-            "semverRange": ""
+            "name": "AVR-Dx_DFP",
+            "semverRange": "^2.7.321"
         },
         "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

@@ -9,53 +9,61 @@
 </a>
 
 # AVR128DB48 I2C_Host Example Component for CNano Explorer: Find all I2C Clients on Bus (Callbacks, Printf-errors)
-The following is the output, when Printf is selected as the Visualization Output. 
 
-![alt text](images/Find_all_i2c_clients_callbacks_printf_avrDB.png)
+The [I<sup>2</sup>C Host Find all Clients Example](https://onlinedocs.microchip.com/v2/keyword-lookup?keyword=I2C.HOST.EX.RUNNING.I2C.HOST.FIND.CLIENTS&version=latest&redirect=true "I2C Proximity Sensor 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 Callbacks implementation, with the Printf with error handling visualization. 
 
-Full confgiguration. 
-![alt text](images/Find_all_i2c_clients_callbacks_printfErrors_avrDB_configuration.png)
+![alt text](images/Find_all_i2c_clients_callbacks_printf_avrDB_intro.png)
 
-The same configuration, when Printf with error handling is selected, generates the following output: 
+
+In this example, an I<sup>2</sup>C write is attempted for all possible I<sup>2</sup>C client addresses to identify clients that respond with an ACK. This builds up a list of valid I2C_Client addresses on the bus, displaying this as a printf message over the Universal Asynchronous Receiver and Transmitter (UART). The example uses a polled implementation.
+
+As each address is attempted in the Prinft with Error Checking visualization output, an Acknowledge (ACK) or No-Acknowledge (NACK) message is printed over the UART.
+
+When using the [MPLAB® Data Visualizer](https://www.microchip.com/en-us/tools-resources/debug/mplab-data-visualizer "MPLAB® Data Visualizer"), after configuring the Terminal to a baudrate of 115200 and clicking to 'display as text in the terminal' the example will look as shown below.
+
+The below image of the MPLAB Data Visualizer shows the application running on the Curiosity Nano Explorer board, where ten client devices have been found: 
 
 ![alt text](images/Find_all_i2c_clients_callbacks_printfErrors_avrDB.png)
 
-<!-- This is where the introduction to the example goes, including mentioning the peripherals used -->
+## Setup
 
-## Related Documentation
+The following outlines the complete MCC Melody configuration, including all the selected tasks that have been implemented in this example, as seen in the MPLAB Code Configurator (MCC) Melody Builder.
 
-<!-- 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) -->
+![alt text](images\Find_all_i2c_clients_callbacks_printfErrors_avrDB_configuration.png)
 
-## 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/) -->
 
-- 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)
+## 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. 
 
-## Hardware Used
 
-<!-- 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) -->
+## Related Documentation
 
-## Setup
+- [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")
 
-<!-- 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 -->
+- [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")
 
-## Operation
+- [AVR128DB48 Data Sheet](https://ww1.microchip.com/downloads/en/DeviceDoc/AVR128DB28-32-48-64-DataSheet-DS40002247A.pdf "AVR128DB48 Data Sheet")
+
+## 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
 
-<!-- Explain how to operate the example. Depending on complexity, step-by-step instructions and/or tables and/or images can be used -->
+- [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
 
-## Summary
+Open the MCC Content Manager ![CM_icon](images/Icon-MPLAB-CM24.png) to verify the MCC Core and MCC Melody Core versions. 
+
+![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-find-all-i2c-clients-on-bus-callback-printf-errors.X/avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors.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:           1. Find all I2C clients on bus 
@@ -92,7 +92,8 @@ uint8_t I2C_ProbeAll(const i2c_host_interface_t* i2cHost, uint8_t *deviceAddress
 void I2C_FindAndReportDevices(void)
 {
     uint8_t devicesFound = 0;
-    uint8_t deviceAddresses[128]; 
+    uint8_t deviceAddresses[64];  // Note: Adjust the size of this array if memory constraints arise. 
+                                  // This array only needs to store the addresses of successfully detected devices.
 
     devicesFound = I2C_ProbeAll(i2cHost, deviceAddresses);
 
@@ -112,7 +113,8 @@ int main(void)
 
     SYSTEM_Initialize();  
 
-    (int) printf("Example: 1. Find all I2C clients on bus, Implementation: Interrupts with callbacks, Visualization: Printf with error handling\r\n\r\n");
+    (int) printf("Example: 1. Find all I2C clients on bus, Implementation: Interrupts with callbacks, Visualization: Printf with error handling\r\n");
+    (int) printf("MCU Device family: AVR \r\n\r\n");
     (int) printf("Looking for all devices on i2cHost\r\n");
     I2C_FindAndReportDevices(); 
 

avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors.X/avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors.mc3.bak0

@@ -2,31 +2,31 @@
 
 manifest_file_version: 1.0.0
 project: avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors
-creation_date: 2025-04-10T12:56:46.868+02:00[Europe/Berlin]
+creation_date: 2025-10-20T14:22:33.400+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.8.1}
-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.0}
+- {name: '@mchp-mcc/avr-8bit', type: MELODY, version: 4.14.2}
 - {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/avr8-pin-manager', type: MELODY, version: 4.6.2}
 - {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/example-i2c-host', type: MELODY, version: 1.0.1}
+- {name: '@mchp-mcc/i2c-host-driver', type: MELODY, version: 1.0.5}
 - {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/pin-content-processor', type: MELODY, version: 3.11.0}
+- {name: '@mchp-mcc/scf-avr8-clkctrl-v3', type: MELODY, version: 2.0.10}
+- {name: '@mchp-mcc/scf-avr8-interrupt-v1', type: MELODY, version: 5.0.12}
 - {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/scf-avr8-usart-v1', type: MELODY, version: 10.3.1}
 - {name: '@mchp-mcc/uart-driver', type: MELODY, version: 1.10.2}

avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors.X/avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors.mc3.bak1

@@ -2,31 +2,31 @@
 
 manifest_file_version: 1.0.0
 project: avr128db48-find-all-i2c-clients-on-bus-callback-printf-errors
-creation_date: 2025-04-10T12:56:46.838+02:00[Europe/Berlin]
+creation_date: 2025-10-20T14:22:33.349+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.8.1}
-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.0}
+- {name: '@mchp-mcc/avr-8bit', type: MELODY, version: 4.14.2}
 - {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/avr8-pin-manager', type: MELODY, version: 4.6.2}
 - {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/example-i2c-host', type: MELODY, version: 1.0.1}
+- {name: '@mchp-mcc/i2c-host-driver', type: MELODY, version: 1.0.5}
 - {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/pin-content-processor', type: MELODY, version: 3.11.0}
+- {name: '@mchp-mcc/scf-avr8-clkctrl-v3', type: MELODY, version: 2.0.10}
+- {name: '@mchp-mcc/scf-avr8-interrupt-v1', type: MELODY, version: 5.0.12}
 - {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/scf-avr8-usart-v1', type: MELODY, version: 10.3.1}
 - {name: '@mchp-mcc/uart-driver', type: MELODY, version: 1.10.2}