Added doxygen style documentation to devmem2 module

diff --git a/src/devmem2.c b/src/devmem2.c
index abcd7e3..cd33ceb 100644 (file)
--- a/src/devmem2.c
+++ b/src/devmem2.c
@@ -3,8 +3,8 @@
 // Author: Jan-Derk Bakker, Daniel Giritzer
 // Date: 2017-06-02
 // Description: Simple module to read/write from/to any location in memory.
 // Author: Jan-Derk Bakker, Daniel Giritzer
 // Date: 2017-06-02
 // Description: Simple module to read/write from/to any location in memory.

-// Remarks: -
-// Revision: 1
+// Remarks: assumes a 4k page size and that sizeof(unsigned long) == 4
+// Revision: 1.2

 // Copyright (C) 2000, Jan-Derk Bakker (J.D.Bakker@its.tudelft.nl)
 // Copyright (C) 2017, Daniel Giritzer (giri@nwrk.biz)
 ///////////////////////////////////////////////////////////////////////////
 // Copyright (C) 2000, Jan-Derk Bakker (J.D.Bakker@its.tudelft.nl)
 // Copyright (C) 2017, Daniel Giritzer (giri@nwrk.biz)
 ///////////////////////////////////////////////////////////////////////////


@@ -26,13 +26,32 @@
 #define MAP_SIZE 4096UL
 #define MAP_MASK (MAP_SIZE - 1)
 
 #define MAP_SIZE 4096UL
 #define MAP_MASK (MAP_SIZE - 1)
 

+
+/////////////////////////////////////////////////
+/// \brief This function is called by the module
+///        if an error occurs.
+///
+/// \param char* Custom error Message.
+/////////////////////////////////////////////////

 static void ERROR(char* custom)
 {
 static void ERROR(char* custom)
 {

+    //print custom error message

     fprintf(stderr, "Error: %s \n", custom);
     fprintf(stderr, "Error: %s \n", custom);

+
+    //print further information

     fprintf(stderr, "Info: %d, %s\n",
             errno, strerror(errno));
 }
 
     fprintf(stderr, "Info: %d, %s\n",
             errno, strerror(errno));
 }
 

+/////////////////////////////////////////////////
+/// \brief This function allows writing to memory
+///        on the specified address.
+///
+/// \param char* Address to write to
+/// \param char* Value to write
+/// \param int Access type, should be 'w' (word),
+///        'h' (halfword), 'b'(byte)
+/////////////////////////////////////////////////

 int writemem(char* address, char* value, int access_type)
 {
     int fd;
 int writemem(char* address, char* value, int access_type)
 {
     int fd;


@@ -87,6 +106,15 @@ int writemem(char* address, char* value, int access_type)
     return EXIT_SUCCESS;
 }
 
     return EXIT_SUCCESS;
 }
 

+/////////////////////////////////////////////////
+/// \brief This function allows reading the memory
+///        on the specified address.
+///
+/// \param char* Address to read from
+/// \param int Access type, should be 'w' (word),
+///        'h' (halfword), 'b'(byte)
+/// \param unsigned long* pointer result variable
+/////////////////////////////////////////////////

 int readmem(char* address, int access_type, unsigned long *result)
 {
     int fd;
 int readmem(char* address, int access_type, unsigned long *result)
 {
     int fd;

diff --git a/src/devmem2.h b/src/devmem2.h
index bd5b399..c688786 100644 (file)
--- a/src/devmem2.h
+++ b/src/devmem2.h
@@ -1,20 +1,36 @@
 ///////////////////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////////////////

-// Workfile: devmem2.h (Implementation)
+// Workfile: devmem2.h (Header)

 // Author: Jan-Derk Bakker, Daniel Giritzer
 // Date: 2017-06-02
 // Description: Simple module to read/write from/to any location in memory.
 // Author: Jan-Derk Bakker, Daniel Giritzer
 // Date: 2017-06-02
 // Description: Simple module to read/write from/to any location in memory.

-// Remarks: -
-// Revision: 1
+// Remarks: assumes a 4k page size and that sizeof(unsigned long) == 4
+// Revision: 1.2

 // Copyright (C) 2000, Jan-Derk Bakker (J.D.Bakker@its.tudelft.nl)
 // Copyright (C) 2017, Daniel Giritzer (giri@nwrk.biz)
 ///////////////////////////////////////////////////////////////////////////
 #ifndef DEVMEM2_H_INCLUDED
 #define DEVMEM2_H_INCLUDED
 
 // Copyright (C) 2000, Jan-Derk Bakker (J.D.Bakker@its.tudelft.nl)
 // Copyright (C) 2017, Daniel Giritzer (giri@nwrk.biz)
 ///////////////////////////////////////////////////////////////////////////
 #ifndef DEVMEM2_H_INCLUDED
 #define DEVMEM2_H_INCLUDED
 

-
+/////////////////////////////////////////////////
+/// \brief This function allows writing to memory
+///        on the specified address.
+///
+/// \param char* Address to write to
+/// \param char* Value to write
+/// \param int Access type, should be 'w' (word),
+///        'h' (halfword), 'b'(byte)
+/////////////////////////////////////////////////

 int writemem(char* address, char* value, int access_type);
 
 int writemem(char* address, char* value, int access_type);
 

+/////////////////////////////////////////////////
+/// \brief This function allows reading the memory
+///        on the specified address.
+///
+/// \param char* Address to read from
+/// \param int Access type, should be 'w' (word),
+///        'h' (halfword), 'b'(byte)
+/// \param unsigned long* pointer result variable
+/////////////////////////////////////////////////

 int readmem(char* address, int access_type, unsigned long *result);
 
 int readmem(char* address, int access_type, unsigned long *result);
 

-

 #endif // DEVMEM2_H_INCLUDED
 #endif // DEVMEM2_H_INCLUDED

diff --git a/src/main.c b/src/main.c
index 089aad9..b6c0626 100644 (file)
--- a/src/main.c
+++ b/src/main.c
@@ -1,3 +1,12 @@
+///////////////////////////////////////////////////////////////////////////
+// Workfile: devmem2_test.c (Implementation)
+// Author: Daniel Giritzer
+// Date: 2017-06-02
+// Description: Simple Testdriver for the devmem2 module
+// Remarks: -
+// Revision: 1
+// Copyright (C) 2017, Daniel Giritzer (giri@nwrk.biz)
+///////////////////////////////////////////////////////////////////////////

 #include <stdio.h>
 #include <stdlib.h>
 #include "devmem2.h"
 #include <stdio.h>
 #include <stdlib.h>
 #include "devmem2.h"


@@ -6,8 +15,13 @@ int main()
 {
     unsigned long readfrommemory = 0;
 
 {
     unsigned long readfrommemory = 0;
 

+    //Testing writemem
+    writemem("0x01E00130", "0x10140025", 'w');
+
+    //Testing readmem

     readmem("0x01E00130", 'w', &readfrommemory);
 
     readmem("0x01E00130", 'w', &readfrommemory);
 

+    //Print read value to stdout

     printf("Value: 0x%X \n", (unsigned int)readfrommemory);
     return 0;
 }
     printf("Value: 0x%X \n", (unsigned int)readfrommemory);
     return 0;
 }