Updating comments

Author: paddy3696

niosv_c/niosv_c_helloworld_ocm_mem_test/sources/sw/app/main.c

@@ -1,44 +1,114 @@
-#include <stdio.h> // Standard I/O functions
-#include <stdint.h> // Standard integer types
-#include "io.h" // I/O functions for memory-mapped I/O
-#include <unistd.h> // Standard library for usleep function
-#include <system.h> // System definitions
-#include "altera_avalon_sysid_qsys_regs.h" // Altera Avalon SysID Qsys register definitions
+#include <stdio.h>
+#include <stdint.h>
+#include "io.h"
+#include <unistd.h>
+#include <system.h>
+#include "altera_avalon_sysid_qsys_regs.h"
 
-#define OCM_BASE INTEL_ONCHIP_MEMORY_0_BASE // Base address for on-chip memory
+#define OCM_BASE INTEL_ONCHIP_MEMORY_0_BASE
 
-int main() {
-    int p; // Variable to store memory value
-    int p_updated; // Variable to store updated memory value
-    int sys_id; // Variable to store system ID (unused)
-    int i; // Loop counter
+#if 0
+// Using usleep as the delay function
+int usleep(useconds_t usec);
 
+// Function to test PIO functionality
+int pio_test()
+{
+    int count = 0;
+    int i;
+    int pio_err = 0;
+    printf("Application to toggle the PIOs- [4:0] \n");
+
+    while (count < 64)
+    {
+        i = count & 0xf;
+        
+        // Write data to the PIO register at base address PIO_0_BASE
+        IOWR_ALTERA_AVALON_PIO_DATA(PIO_0_BASE, count & 0xf);
+        
+        // Introduce a short delay
+        usleep(100);
+        
+        // Read back data from the PIO register
+        printf("DATA READBACK FROM PIO_0_BASE is 0x%x \n", IORD_ALTERA_AVALON_PIO_DATA(PIO_0_BASE));
+
+        // Verify if the written data matches the read data
+        if (i != IORD_ALTERA_AVALON_PIO_DATA(PIO_0_BASE))
+        {
+            printf("Data MISMATCH - TEST FAILED \n");
+            pio_err = pio_err + 1;
+        }
+        else
+        {
+            printf("DATA MATCHED - TEST PASSED \n");
+        }
+        count++;
+    }
+    return pio_err;
+}
+#endif
+
+int main()
+{
+    int p;
+    int p_updated;
+    int sys_id;
+    int i;
+    
     // Print initial messages
-    printf("Hello World from Agilex-5 NIOSV/c core! \n");
+    printf("Hello World from Agilex-5  NIOSV/c core! \n");
     printf("Application will execute Memory Test \n");
-
-    // Print starting message for memory test
+    
+    // Start memory test by reading and writing values to on-chip memory
     printf("Starting Memory test \n");
 
-    // Loop to test memory locations
-    for (i = 0; i < 32; i = i + 4) {
-        // Read value from memory
+    for (i = 0; i < 32; i = i + 4)
+    {
+        // Read value from memory at specified base address and offset
         p = IORD_32DIRECT(OCM_BASE, i);
-        printf("Value at memory location 0x%x with offset %d is 0x%x\n", OCM_BASE, i, p);
-
-        // Write a test value to memory
+        printf("value at memory location 0x%x with offset %d is 0x%x\n", OCM_BASE, i, p);
+        
+        // Write a test pattern to memory
         IOWR_32DIRECT(OCM_BASE, i, 0xa5a5a5a5);
-        // Read the updated value from memory
+        
+        // Read back the value to verify the write operation
         p_updated = IORD_32DIRECT(OCM_BASE, i);
         printf("After write: value at memory location 0x%x with offset %d is 0x%x\n", OCM_BASE, i, p_updated);
 
-        // Check if the write was successful
-        if (p_updated == 0xa5a5a5a5) {
-            printf("Memory test passed at offset %d\n", i);
-        } else {
-            printf("Memory test failed at offset %d\n", i);
+        // Verify if the written value matches expected data
+        if (p_updated == 0xa5a5a5a5)
+        {
+            printf("Memory write test PASSED\n");
+        }
+        else
+        {
+            printf("Memory write test FAILED at location 0x%X\n", (OCM_BASE + i));
         }
     }
 
-    return 0; // Exit the application
-}
+    printf("Memory Test Complete \n");
+
+#if 0
+    int pio_fail_flag;
+    
+    // Run the PIO test function
+    pio_fail_flag = pio_test();
+    
+    // Check the result of the PIO test
+    if (pio_fail_flag != 0)
+    {
+        printf("NIOSV-PIO Test failed with PIO_ERR = %d\n", pio_fail_flag);
+    }
+    else
+    {
+        printf("NIOSV-PIO Test PASSED \n");
+    }
+#endif
+
+    // Read and print the System ID from the peripheral core
+    printf("Print the value of System ID \n");
+    sys_id = IORD_ALTERA_AVALON_SYSID_QSYS_ID(SYSID_QSYS_0_BASE); // Read System ID from the Qsys system ID peripheral
+    printf("System ID from Peripheral core is 0x%X \n", sys_id);
+
+    return 0;
+}