Changeset 643 for trunk/libs/libalmosmkh/almosmkh.h

Timestamp:

Oct 17, 2019, 3:14:01 PM (5 years ago)

Author:

alain

Message:

Introduce FBF related syscalls.

File:

• trunk/libs/libalmosmkh/almosmkh.h (modified) (3 diffs)

trunk/libs/libalmosmkh/almosmkh.h

@@ -380 +380 @@
 #define MALLOC_INITIALIZED         0xBABEF00D   // magic number when initialised
 #define MALLOC_MIN_BLOCK_SIZE      0x40         // 64 bytes
-#define MALLOC_LOCAL_STORE_SIZE    0x800000     // 8 Mbytes     
+#define MALLOC_LOCAL_STORE_SIZE    0x2000000    // 32 Mbytes     
 #define MALLOC_MAX_CLUSTERS        0x100        // 256 clusters
 
@@ -496 +496 @@
 /*****************************************************************************************
  * This blocking function creates N working threads that execute the code defined
- * by the <work_func> and <work_args> arguments.
+ * by the <work_func> and <work_args> arguments, and returns only when all working
+ * threads completed.
  * The number N of created threads is entirely defined by the <root_level> argument.
  * This value defines an abstract quad-tree, with a square base : level in [0,1,2,3,4],
@@ -521 +522 @@
                              void         * parent_barriers_array );
 
+/********* Non standard (ALMOS-MKH specific) Frame Buffer access syscalls   *************/
+
+//////////////////////////////////////////////////////////////////////////////////////////
+// The following system calls can be used to access the SoCLib Frame Buffer, that
+// is a very simple graphic controller, that is seen by the software as a single
+// buffer of <height> lines of <width> pixels. 
+//////////////////////////////////////////////////////////////////////////////////////////
+
+/*****************************************************************************************
+ * This function returns in the <width> and <height> arguments the buffer size.
+ *****************************************************************************************
+ * @ width   : [out] number of pixels per line.
+ * @ height  : [out] number of lines.
+ * @ type    : [out] pixel encoding type.
+ * @ returns 0 if success / returns -1 if error.
+ ****************************************************************************************/
+int fbf_get_config( int * width,
+                    int * height,
+                    int * type );
+
+/*****************************************************************************************
+ * This blocking function moves <length> bytes from the frame buffer, starting 
+ * from <offset>, to the user buffer defined by <buffer> argument.
+ *****************************************************************************************
+ * @ buffer  : pointer on buffer in user space.
+ * @ length  : number of pixels (one byte per pixel).
+ * @ offset  : first pixel index in frame buffer.
+ * @ returns 0 if success / returns -1 if error.
+ ****************************************************************************************/
+int fbf_read( void * buffer,
+              int    length,
+              int    offset );
+
+/*****************************************************************************************
+ * This blocking function moves <length> bytes from the user buffer defined by <buffer>
+ * argument to the frame buffer, starting at <offset> in frame buffer.
+ *****************************************************************************************
+ * @ buffer  : pointer on buffer in user space.
+ * @ length  : number of pixels (one byte per pixel).
+ * @ offset  : first pixel index in frame buffer.
+ * @ returns 0 if success / returns -1 if error.
+ ****************************************************************************************/
+int fbf_write( void * buffer,
+               int    length,
+               int    offset );
+
 #endif /* _LIBALMOSMKH_H_ */