Blame

8c1491 Bob Green 2026-06-02 12:30:13
1
# Runtime (crt0)
19a02c Bob Green 2026-06-02 12:15:40
2
3
By default, when using my link scripts, the standard runtime is initialised by crt0 as follows:
4
048596 Bob Green 2026-06-02 12:29:29
5
| Address | Size | Link Script Variable |Comment |
6
| ------- | ------- | ------- | ------- |
7
| `0x03fffe` | ~256k | `_STACK_SIZE` |Stack (SSP). Grows towards 0. At round about 0x0000400 it would start stomping all over the memory area used by the monitor |
8
| `0x040000` | n/a | `_RUN_ADDRESS` | Start of user program (.text), followed by initialised data (.data) and then unititialised data (.bss). The .bss area is initialised to all zeroes before main() is called. |
aa3982 Bob Green 2026-06-02 12:27:17
9
12cd8e Bob Green 2026-06-02 12:51:29
10
You can override the values at link time by using the linker option:
11
12
```
13
--defsym=<symbol_name>=<value>
14
```
15
You can use this option as many times as needed.
16
bb124e Bob Green 2026-06-02 12:56:47
17
## In Detail
18
### Heap
e7d651 Bob Green 2026-06-02 12:27:24
19
7b8b28 Bob Green 2026-06-02 12:27:49
20
`crt0` allocates all free memory from the end of the .bss area to the end of ram to the heap (malloc/free).
018e16 Bob Green 2026-06-02 12:44:24
21
bb124e Bob Green 2026-06-02 12:56:47
22
### Global Variables
018e16 Bob Green 2026-06-02 12:44:24
23
crt0 sets the following global variables:
24
25
**uint8_t cpu_speed_mhz**. This uses the counter in the PI/T to figure out roughly how fast the CPU is being clocked at. Within a MHz or so.
26
27
**uint8_t cpu_type**. Figures out what CPU is installed: 0 - 68000/68008, 1 - 68010, 2 - 68020, 3 - 68030
28
29
**uint8_t running_in_rom**. When non-zero, indicates that the code is running in ROM. 0 indicates it's running in RAM.
30
dcb313 Bob Green 2026-06-02 12:49:16
31
To access any of these variables, simply ```#include <machine.h.>```
bb124e Bob Green 2026-06-02 12:56:47
32
33
### On Exit
34
When `main()` returns or when `exit()` is called, a non-zero exit code will be printed as follows:
35
```
36
exited with status: <value>
37
```
38
No message is printed if the exit code was zero.
39
Control will then be passed back to the monitor