6502/millfork
1
0
Fork 0
mirror of https://github.com/KarolS/millfork.git synced 2024-11-04 09:04:33 +00:00
Code Issues Projects Releases Wiki Activity
bf47473162
millfork/docs/abi/calling-convention.md
Karol Stasiak cb92b09942 Improvements related to large types: 
– returning types larger than 2
– fastcall for 1 parameter of size 3 or 4 on Z80
– more integer types (up to int128)
– marked farword as a deprecated alias of int24
2018-07-30 14:33:16 +02:00

2.4 KiB
Raw Blame History

< back to index

Millfork calling convention

Note: all the info below may change without any warning and is given only for debugging purposes.

6502

Parameters:

  • if the function has one parameter of size one byte, it is passed via the A register

  • otherwise, all parameters are passed via static locations

Return values:

  • one-byte return values are passed via the A register

  • two-byte return values are passed via the A (low byte) and X (high byte) register

  • otherwise, the return value is passed via a static location

Register preservation:

  • callee may clobber all three registers (A, X, Y) and most flags (Z, V, C, N, and also I if using inline assembly)

  • callee expects the D flag to be clear and will leave it clear

  • on 65816: callee will preserve the emulation flag (setting the emulation flag correctly is the responsibility of the initialization code)

  • on 65816 in native mode:

    • callee expects the M and X flag to be set and will leave them set (8-bit accumulator and index registers by default)

    • callee expects the direct page register to be set to 0000 and will not change it

Z80

Parameters:

  • if the function has one parameter of size one byte, it is passed via the A register

  • if the function has one parameter of size two bytes, it is passed via the HL register pair

  • if the function has one parameter of size three bytes, its least significant two bytes are passed via the HL register pair and the most significant byte is passed via the E register

  • if the function has one parameter of size four bytes, its least significant word is passed via the HL register pair and the most significant word is passed via the DE register pair

  • otherwise, all parameters are passed via static locations

Return values:

  • one-byte return values are passed via the A register

  • two-byte return values are passed via the HL register pair

  • in case of three-byte return values, its least significant two bytes are passed via the HL register pair and the most significant byte is passed via the E register

  • in case of four-byte return values, its least significant word is passed via the HL register pair and the most significant word is passed via the DE register pair

  • otherwise, the return value is passed via a static location

Register preservation:

  • callee may clobber all flags

  • callee may clobber all registers except for IX, IY and shadow registers