Static Memory Allocation - Versionsgeschichte

Mat: /* Index */

2023-11-05T16:51:05Z

‎Index

Mat: /* Setup */

2023-11-05T16:42:22Z

‎Setup

Mat: /* Download */

2023-11-05T16:40:30Z

‎Download

Mat: /* Samples */

2023-11-04T16:17:06Z

‎Samples

Mat am 14. Juli 2019 um 04:14 Uhr

2019-07-14T04:14:12Z

Mat: /* Interface description */

2019-07-04T06:08:59Z

‎Interface description

Mat: /* Interface description */

2019-07-04T06:08:34Z

‎Interface description

Mat: Die Seite wurde neu angelegt: „== Overview == In most applications, dynamic memory allocation is not needed, instead, it is allocated one time (either at the compile-stage or during the boot…“

2019-06-28T01:42:20Z

Die Seite wurde neu angelegt: „== Overview == In most applications, dynamic memory allocation is not needed, instead, it is allocated one time (either at the compile-stage or during the boot…“

Neue Seite

== Overview ==
In most applications, dynamic memory allocation is not needed, instead, it is allocated one time (either at the compile-stage or during the boot process) and unchanged during run-time.
Where dynamic memory is not needed, but to maintain compatibility, this static allocation library is used.

The remaining memory from the end of global declared variables to the start of the stack spaces and also external memory (Xram), if available, is managed by the library (configurable).

== How to use it ==
=== Setup ===

Create an ''inc'' subfolder to your project and copy the files ''os_common.inc'', ''os_memory.inc'' and ''os_malloc_static.inc'' into the folder.

Include the library:

<pre>' any const option must be placed above the file include
Const Os_mem_free_start = ### ' mandatory
$include "inc\os_malloc_static.inc"</pre>

The start adress of the free memory area can not be determined automatically (Bascom-AVR 2.0.8.1). It can be found by examining the compile report (with setting ''Options->Compiler->Output->Show internal variables'' enabled), the last variable (with the highest adress) plus the byte size is the adress of the first unused byte (refer to [[TLSF_Dynamic_Memory_Allocation#Compiler_report_example|TLSF Dynamic Memory Allocation]]).

=== Managing memory ===
The library maintains a pointer to the first free memory position, memory requests are served in a consecutive order (incrementing the pointer by the requested size). If the request can't be fullfilled, the value 0 is returned. The application has to check for that return value and react accordingly, it is also responsible not to write outside of the requested block of memory. Allocated memory is NOT cleared (set to 0) by the library. Releasing memory for use in further requests is not possible.

With no external memory, 16 bit adress width (Word variable type) is used, with external memory 24 bits are used (DWord type).

<pre>Dim Myblockofmemory As [Word/Dword]
Myblockofmemory = Malloc([Size])
If Myblockofmemory = 0 Then
' memory allocation error handling (not enough free memory)
End If</pre>

== Interface description ==
The following constants have to be defined prior to including the library. The values shown here are default values if the constant is not defined by the user.

<pre>Const Os_mem_free_start = [&H200/with XRAM: &H2000]</pre>
MANDATORY parameter, as described in [[#Setup|Setup]]. For reasons, it has also default values.

<pre>Const Os_task_dbg_metrics = 1</pre>

<pre>Dim Available_memory As Word</pre>

<pre>#if Os_big_ram = False
Function Malloc(byval Size As Word) As Word
#else
Function Malloc(byval Size As Dword) As Dword
#endif</pre>

== Samples ==
WIP

== Download ==
* [http://www.braunecker.at/downloads/memory_allocators.zip Memory Allocators version 0.1]

== Change log ==
=== Version 0.1 (##.##.2019) ===
* Initial release.

← Nächstältere Version		Version vom 5. November 2023, 16:51 Uhr
Zeile 5:		Zeile 5:
	* [[Bascom Precompiler\|''[OOP 3/3] Bascom-Precompiler'']]		* [[Bascom Precompiler\|''[OOP 3/3] Bascom-Precompiler'']]

		+
		+	* [https://www.mcselec.com/index2.php?option=com_forum&Itemid=59&page=viewtopic&p=83584#83584 Forum thread]

	== Overview ==		== Overview ==

← Nächstältere Version		Version vom 5. November 2023, 16:40 Uhr
Zeile 188:		Zeile 188:
	== Download ==		== Download ==

−	[~~[Bascom OOP~~ & Precompiler ~~Download]~~]	+	* [http://www.braunecker.at/downloads/memory-allocators/memory-allocators-1-0.zip Memory Allocators & Precompiler Package 1.0]

@@ Zeile 63: / Zeile 63: @@
 == Samples ==
-WIP
+=== M32 (runs in Simulator) ===
 == Download ==
 [[Bascom OOP & Precompiler Download]]

← Nächstältere Version		Version vom 4. Juli 2019, 06:08 Uhr
Zeile 45:		Zeile 45:

	<pre>Dim Available_memory As Word/Dword</pre>		<pre>Dim Available_memory As Word/Dword</pre>
−	If the constant ''Os_task_dbg_metrics'' is defined, the remaining memory is available to the application by this variable.	+	If the constant ''Os_task_dbg_metrics'' is defined, the remaining memory is available to the application via this variable.

@@ Zeile 19: / Zeile 19: @@
 Include the library:
 <pre>' any const option must be placed above the file include
-Const Os_mem_free_start = ###                         ' mandatory
+Const Os_mem_free_size = ###                         ' mandatory
-$include "inc\os_malloc_static.inc"</pre>
+$include "inc\os_malloc_tlsf.inc"</pre>
 === Managing memory ===

@@ Zeile 1: / Zeile 1: @@
 == Overview ==
 In most applications, dynamic memory allocation is not needed, instead, it is allocated one time (either at the compile-stage or during the boot process) and unchanged during run-time.
@@ Zeile 60: / Zeile 67: @@
 == Download ==
-== Change log ==
+[[Bascom OOP & Precompiler Download]]

@@ Zeile 41: / Zeile 41: @@
 <pre>Const Os_task_dbg_metrics = 1</pre>
-<pre>Dim Available_memory As Word</pre>
+<pre>Dim Available_memory As Word/Dword</pre>
@@ Zeile 51: / Zeile 53: @@
     Function Malloc(byval Size As Dword) As Dword
 #endif</pre>
 == Samples ==