FF55 (rHDMA5) contradicts Pan Docs

[nummacway]

Pan Docs say:

Reading from Register FF55 [...], a value of $FF indicates that the transfer has completed.

and

Reading Bit 7 of FF55 can be used to confirm if the DMA transfer is active (1=Not Active, 0=Active).

hardware.inc says bit 7 is 0 when not busy:

def B_VDMA_LEN_BUSY equ 7 ; on read: is a VRAM DMA active?
    def VDMA_LEN_BUSY equ 1 << B_VDMA_LEN_BUSY
        def VDMA_LEN_NO  equ 0 << B_VDMA_LEN_BUSY
        def VDMA_LEN_YES equ 1 << B_VDMA_LEN_BUSY

[Rangi42]

Thanks! hardware.inc v4.10 added a lot of per-bit-value constants, but got those two backwards. Just have to swap them around:

        def VDMA_LEN_YES equ 0 << B_VDMA_LEN_BUSY
        def VDMA_LEN_NO  equ 1 << B_VDMA_LEN_BUSY

[pinobatch]

🚲️🛖️ Is there a reason why they're called YES and NO rather than RUN and STOP or the like? Compare to how Yes/No/Cancel buttons in alert boxes were deprecated in favor of labeling buttons with distinct verbs like Save/Discard/Cancel or Try Again/Cancel.

[Rangi42]

@pinobatch Want to open an issue listing suggested naming change(s) like that, for the next major release?

[nummacway]

Thanks! hardware.inc v4.10 added a lot of per-bit-value constants

This is quite inconsistent.

• rVBK has no B_VBK_BANK equ 0 (not that it makes much sense, but other registers like the entirely useless BANK register do have one for B_BANK_0)
• DMG color mapping (rBGP, rOBP0, rOBP1) color IDs have no constants at all (but shades do)
• While there are trivial bit constants for many rLCDC bits, no such constants exist for rSTAT and most OAMA_FLAGS
• While rLCDC has distinct constants for mask and whatever a set bit means for that bit, rBANK and OAMA_FLAGS do not have this

This is only for video registers. (As part of my "cheat sheet project", I'm reading through all the GBDEV documentation to make a proper A4 cheat sheet on every topic, for a total of 4 or 5. After finishing the instruction cheat sheet, I'm currently working on video and RGBASM syntax.)