Mat: /* Index */

2023-11-05T16:51:36Z

‎Index

Mat: /* Download */

2023-11-05T16:40:10Z

‎Download

Mat: /* Enumerations */

2023-11-04T19:32:57Z

‎Enumerations

Mat: /* Command Line */

2023-11-04T16:36:30Z

‎Command Line

Mat: /* Command Line */

2023-11-04T16:35:53Z

‎Command Line

Mat am 14. Juli 2019 um 04:06 Uhr

2019-07-14T04:06:21Z

Mat: Die Seite wurde neu angelegt: „== Overview == The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original f…“

2019-07-13T23:47:11Z

Die Seite wurde neu angelegt: „== Overview == The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original f…“

Neue Seite

== Overview ==
The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original files and invokes ''bascomp.exe''. Original files are not touched.
It supports the following enhancements:
* Macros with arguments
* RAM and ROM address data type
* Enumerations
* Conditional Compilation Checks: #if Subexist(""), #if Labelexist("")
* Composed data types (structures) and OOP concepts
* Automatic generated constants: _sourceline, _sourcefileline, _filename, _subroutinename, _precompiler, _currentdate, _currenttime, _buildnumber, _freeramstart, _isrstackcount
* Export disassembly (optionally annotated with original source code)

Some precompiler steps involve parsing the compiler output, in that case, a second compile step is then performed using the gathered data.

== Functional description ==
=== Macros with arguments ===
'''Syntax:'''
<pre>Macro [MacroName] ([ArgumentList])
[Statements]
End Macro</pre>
These macros work the same as the built-in ones, but accept additional arguments, which work as a textual replacement. Therefore arguments are type-agnostic.
Also supports argument concatenation using "." (argument concatenation has priority over the type-member-/enum-access qualifier "."). Nested macros are allowed.

'''Example 1:'''
<pre>Macro Mymacro(printtext)
Print "This is my text: "; printtext
End Macro</pre>

Invoking with a string argument:
<pre>Mymacro "some characters"</pre>
Will yield in output:
<pre>Print "This is my text: "; "some characters"</pre>

Invoking with a variable as argument:
<pre>Dim Myvariable As Byte
Mymacro Myvariable</pre>
Output:
<pre>Print "This is my text: "; Myvariable</pre>

'''Example2:'''
<pre>Macro Concat (Arg1, Arg2, Arg3)
Arg1.Arg2 Arg3
End Macro</pre>
Invoking:
<pre>Concat($reg, file, "m32def.dat")</pre>
Output:
<pre>$regfile "m32def.dat"</pre>

=== RAM/ROM address data type ===
Some devices have more than 64K program space and use 24 bit wide addresses (instead of 16 bit) for flash access, which makes porting code between the addressing schemes more tedious.
The same happens with RAM addresses for devices using external memory.
To support this, the precompiler introduces two new variable types: ''Rampointer'' and ''Rompointer''.
They will be assigned a ''Word'' or a ''Dword'' variable type on compilation, according to the currently used addressing schemes.

'''Syntax:'''
<pre>Dim Labeladdress As Rompointer
Dim Myramspace As Rampointer

Sub Testthis(position As Rampointer)
Local Flashdata As Rompointer
End Sub</pre>

=== Enumerations ===
Defines a list of key-value pairs. If no value is specified, the value is either 0 for the first key entry or the value of the previous key + 1. One key/value pair per line.
Usage is like constants, members are accessed using ''[EnumName].[MemberName]''.

'''Syntax:'''
<pre>Enum Myenum
Value1,
Value2 = 5,
Value3
End Enum

Print Myenum.Value1; Myenum.Value2; Myenum.Value3 ' Output: 056</pre>

=== Conditional Compilation Checks ===
The precompiler adds additional symbol-checks to Bascom's conditional compilation switches (they act in the same way the as built-in ''Varexist("")'' directive).

'''Syntax:'''
<pre>#if Subexist("[SubroutineName]")</pre>
<pre>#if Labelexist("[LabelName]")</pre>

=== Composed Data Types ===
A composed data type consists of several data types (intrinsic or other composed types) grouped together in memory.
It supports every available data type (bit, byte, word, integer, dword, long, single, double, string, rampointer, rompointer and composed types) and optionally supports inheritance. Composed types as member field or dimensioned using ''Dim'', ''Local'' or as a subroutine parameter are internally referenced by the Rampointer data type.

To create an instance of the type definition, a memory block of sufficient size has to be reserved and referenced through a variable pointing to the first memory address of that block.
Memberfields are accessed by the "." qualifier. Only assignments of a variable from the memberfield or assignments of the memberfield from a variable or constant are allowed (by now). Internally, these are translated to ''Settype''/''Gettype'' functions as found in ''os_memory.inc''. Bit member fields internally use a byte.

'''Syntax:'''
<pre>Typedef [TypedefName]
[Extends TypedefName]
[MemberFieldName] As [Bit/Byte/Word/Integer/Dword/Long/Single/Double/String*N/TypedefName]
End Typedef

Sub Memberfunction(object As [TypedefName])
Local Anotherobject As [TypedefName]
End Sub

Dim Myinstance As [TypedefName]

Myinstance = Malloc(SizeOf([TypedefName]))

Myinstance.[MemberfieldName] = [Constant/Variable]
Variable = Myinstance.[MemberfieldName]
</pre>

=== Automatic generated constants ===
These keywords are replaced by their value as number or string literal, usage is like constants.

<pre>_sourceline</pre>
(Number) Returns the current line number, inclusive includes.

<pre>_sourcefileline</pre>
(Number) Returns the current line number only counting the current file

<pre>_filename</pre>
(String) Returns the current source file name

<pre>_subroutinename</pre>
(String) Returns the current sub routine name (valid inside Subs/Functions and Label-Return-pairs, empty string if not inside subroutine).

<pre>_precompiler</pre>
(Number) Actually creates a constant containing the precompiler version (current: 1), which could be checked for existence by ''#if Varexist("_precompiler")'' to check if the code is beeing processed using the precompiler.

<pre>_currenttime</pre>
(String) Contains the build time.

<pre>_currentdate</pre>
(String) Contains the build date.

<pre>_freeramstart</pre>
(Number) Returns the first unused memory position. Needs a second compile pass.

<pre>_isrstackcount</pre>
(Number) Returns the used stack size (PUSH statements) inside an ISR. Needs a second compile pass.

<pre>Const _buildnumber = 0</pre>
This constant is treated specially, in the output it will contain the current build number, incremented by 1 on each compilation. Current build count is maintained in a file besides the original source file with the extension ".bld".

=== Precompiler directives ===
<pre>$disasm</pre>
Instructs the precompiler to output a disassembly of the compilation result. Needs a second compile pass.

<pre>$disasmmapped</pre>
Instructs the precompiler to output a disassembly of the compilation result, mapped to the corresponding source lines. Needs a second compile pass.

== Command Line ==
'''Syntax:'''
<pre>prebascomp.exe [FileName] [Options]</pre>

'''Options:'''
<pre>/disasm</pre>
Instructs the precompiler to output a disassembly of the compilation result. Needs a second compile pass.

<pre>/mapped</pre>
Instructs the precompiler to output a disassembly of the compilation result, mapped to the corresponding source lines. Needs a second compile pass.

<pre>/log</pre>
Generate a log file of the precompilation process.

== Download ==

[[Bascom OOP & Precompiler Download]]

← Nächstältere Version		Version vom 5. November 2023, 16:51 Uhr
Zeile 5:		Zeile 5:
	* [OOP 3/3] 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 203:		Zeile 203:
	== 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 200: / Zeile 200: @@
 <pre>/update</pre>
-Force checking of update availability
+Force checking of update availability.
 == Download ==
 [[Bascom OOP & Precompiler Download]]

← Nächstältere Version		Version vom 14. Juli 2019, 04:06 Uhr
Zeile 1:		Zeile 1:
		+	== Index ==
		+	* [[TLSF Dynamic Memory Allocation\|''[OOP 1a/3] Dynamic Memory Allocation using TLSF'']]
		+	* [[Static Memory Allocation\|''[OOP 1b/3] Static Memory Allocation'']]
		+	* [[Object Oriented Programming in Bascom\|''[OOP 2/3] Object Oriented Programming in Bascom'']]
		+	* [OOP 3/3] Bascom-Precompiler
		+
		+
	== Overview ==		== Overview ==
	The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original files and invokes ''bascomp.exe''. Original files are not touched.		The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original files and invokes ''bascomp.exe''. Original files are not touched.

@@ Zeile 83: / Zeile 83: @@
 End Enum
-Print Myenum.Value1; Myenum.Value2; Myenum.Value3          ' Output: 056</pre>
+Print Str(Myenum.Value1); Str(Myenum.Value2); Str(Myenum.Value3)          ' Output: 056</pre>
 === Conditional Compilation Checks ===

Bascom Precompiler - Versionsgeschichte

Mat: /* Index */

Mat: /* Download */

Mat: /* Enumerations */

Mat: /* Command Line */

Mat: /* Command Line */

Mat am 14. Juli 2019 um 04:06 Uhr

Mat: Die Seite wurde neu angelegt: „== Overview == The precompiler processes the Bascom source files (also taking includes into account), outputs the generated source files besides the original f…“