Signature byte

In 65x parlance, a signature byte is the byte that follows certain instructions, including:


 * BRK
 * COP
 * WDM

Each of these instructions will normally advance the PC by two bytes, even though the hardware does not make any direct use of the second "operand" byte.

For this reason, these instructions have been treated both as one-byte and two-byte instructions in various reference documents and assemblers.

BRK and COP
Both of these instructions generate a software interrupt that will be handled by a routine designated in the CPU vector table.
 * COP has a vector at $FFE4.
 * BRK has a vector at $FFE6.

Stack contents for handler: $00, S - (empty, current stack pointer) $01, S - P status byte $02, S - return address low (BRK/COP PC + 2) $03, S - return address high $04, S - return bank K

The COP instruction was originally intended for use with a co-processor, for which the signature byte could indicate a command to send to the co-processor. However, there is no hardware to support this usage on the SNES, and it is simply a second software interrupt, equivalent to BRK.

Without Signature
If the signature byte is not needed, a BRK or COP handler may wish to decrement the return address on the stack before RTI, returning as if it were a one-byte instruction.

With Signature
A software response to BRK or COP</tt> may use the return address on the stack to deduce the location of the operand byte and inspect it.

This might be used for error codes, or as a compact system call dispatch.

WDM
The WDM</tt> instruction was reserved for future use, but was ultimately left unused. It is simply a 2-byte alternative to NOP</tt>.

Mesen's debugger provides a break-on-WDM instruction which can make it convenient as an emulator-only breakpoint.

Assemblers
There is no standard for how assemblers treat BRK or COP. If BRK emits only 1 byte, a signature byte can be added manually with a data byte following.


 * ca65 an optional signature for BRK and COP, allowing either 1 or 2 bytes. WDM always require the signature byte.
 * wla-dx always emits 2 bytes for BRK, COP and WDM. The signature byte defaults to 0 if not given.
 * asar always emits 2 bytes for BRK, COP and WDM. The signature byte defaults to 0 if not given.