From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Platform:Atari ST" |
|---|
| claim | "GEMDOS is trap #1 (vector 0x21), BIOS trap #13 and XBIOS trap #14: the caller pushes arguments, then a 16-bit function number on top of the stack, executes the trap, and the result comes back in D0; the BIOS/XBIOS handler takes the number from the stack, compares it with the table size and calls through a table of longword handlers." |
|---|
| scope | | level | "platform" |
|---|
| applies_to | "Platform:Atari ST" |
|---|
| observed_in | |
|---|
|
|---|
| data | | trigger | "TRAP #1, #13 or #14" |
|---|
| effect | "d0 = (unsigned word)(sp)+ ; if d0 >= table entries return the function number in d0 (unimplemented); else jsr to table[d0]; result in D0" |
|---|
| condition | "BIOS/XBIOS: if SR bit 13 (supervisor) was set when the trap was taken the arguments are on the stack after the exception frame, else on the user stack" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "_biostrap/_xbiostrap load the table and its entry count, biosxbios saves state, picks sp or usp from SR bit 13 (btst #13; the source comment on the jne branch says the opposite), pops the word function number, bounds-checks it and jsr (a0)" |
|---|
| repo | "emutos/emutos" |
|---|
| commit | "02c2db75fc875265c1449efea014450466cf20b7" |
|---|
| path | "bios/vectors.S" |
|---|
| lines | "1266-1332" |
|---|
|
| type | "source" |
|---|
| detail | "osinit installs Setexc(0x21, enter) for TRAP #1 and Setexc(0x22, bdos_trap2) for TRAP #2 (vector number = 0x20 + trap number)" |
|---|
| repo | "emutos/emutos" |
|---|
| commit | "02c2db75fc875265c1449efea014450466cf20b7" |
|---|
| path | "bdos/bdosmain.c" |
|---|
| lines | "320-326" |
|---|
|
| type | "source" |
|---|
| detail | "VEC_BIOS = biostrap; VEC_XBIOS = xbiostrap" |
|---|
| repo | "emutos/emutos" |
|---|
| commit | "02c2db75fc875265c1449efea014450466cf20b7" |
|---|
| path | "bios/bios.c" |
|---|
| lines | "174-175" |
|---|
|
|
|---|
| confidence | "medium" |
|---|
| related | |
|---|
| key | "Trap 1 13 14 calling convention" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T01:57:17.251Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T06:40:13.414Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read emutos bios/vectors.S lines 1255-1340 at 02c2db75: _biostrap/_xbiostrap set d1 = entry count and a0 = table, biosxbios saves the frame, btst #13,d0 / jne keeps sp else loads usp, pops a 16-bit function number, cmp.w d1,d0 / jhs returns the number in d0 for unimplemented, else jsr through the longword table." |
|---|
| notes | "ColdFire (__mcoldfire__) builds have a different frame prologue; the m68k path was read. GEMDOS trap #1 not re-read here." |
|---|
|
|
|---|