mirror of
https://github.com/hsoft/collapseos.git
synced 2024-11-08 12:38:06 +11:00
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# Kernel
|
|
|
|
Bits and pieces of code that you can assemble to build a kernel for your
|
|
machine.
|
|
|
|
These parts are made to be glued together in a single `glue.asm` file you write
|
|
yourself.
|
|
|
|
This code is designed to be assembled by Collapse OS' own [zasm][zasm].
|
|
|
|
## Defines
|
|
|
|
Each part can have its own constants, but some constant are made to be defined
|
|
externally. We already have some of those external definitions in platform
|
|
includes, but we can have more defines than this.
|
|
|
|
Each part has a "DEFINES" section listing the constant it expects to be defined.
|
|
Make sure that you have these constants defined before you include the file.
|
|
|
|
## Variable management
|
|
|
|
Each part can define variables. These variables are defined as addresses in
|
|
RAM. We know where RAM start from the `RAMSTART` constant in platform includes,
|
|
but because those parts are made to be glued together in no pre-defined order,
|
|
we need a system to align variables from different modules in RAM.
|
|
|
|
This is why each part that has variable expect a `<PARTNAME>_RAMSTART`
|
|
constant to be defined and, in turn, defines a `<PARTNAME>_RAMEND` constant to
|
|
carry to the following part.
|
|
|
|
Thus, code that glue parts together could look like:
|
|
|
|
MOD1_RAMSTART .equ RAMSTART
|
|
#include "mod1.asm"
|
|
MOD2_RAMSTART .equ MOD1_RAMEND
|
|
#include "mod2.asm"
|
|
|
|
[zasm]: ../apps/zasm/README.md
|