CC65 NES2 header macro (for use in C)

nes2header.h

/**
 * NES 2.0 header generator for cc65 (nes2header.h)
 * 
 * USAGE: Generates a header for the NES2 format with C macros
 * Before including this header, define the following values 
 * 
 * - NES2_MAPPER, NES2_SUBMAPPER
 *    Sets the mapper (board class) ID.  For example, MMC3 is usually
 *    mapper 4, but TLSROM is 118 and TQROM is 119.  Some mappers have
 *    variants.
 *    NO DEFAULT (Required)
 *    Example: (sets the mapper to MMC3 with submapper variant 1 used by StarTropics)
 *     #define NES2_MAPPER 4
 *     #define NES2_SUBMAPPER 1
 * 
 * - NES2_PRG
 *    Sets the PRG ROM size to sz bytes. Must be multiple of 16384;
 *    should be a power of 2.
 *    NO DEFAULT (Required)
 *    Example: #define NES2_PRG 131072
 * 
 * - NES2_CHR
 *    Sets the CHR ROM size to sz bytes. Must be multiple of 8192;
 *    should be a power of 2.
 *    Default value: 0
 *    Example: #define NES2_CHR 32768
 * 
 * - NES2_WRAM
 *    Sets the (not battery-backed) work RAM size in bytes.
 *    Default is 0.
 *    Example: #define NES2_WRAM 8192
 * 
 * - NES2_BRAM
 *    Sets the battery-backed work RAM size in bytes.
 *    Default is 0.
 *    Example: #define NES2_BRAM 8192
 * 
 * - NES2_CHRBRAM
 *    Sets the battery-backed CHR RAM size in bytes.
 *    Default is 0.
 *    Example: #define NES2_CHRBRAM 8192
 * 
 * - NES2_MIRROR
 *    Sets the mirroring to one of these values:
 *    'H' (horizontal mirroring, vertical arrangement)
 *    'V' (vertical mirroring, horizontal arrangement)
 *    '4' (four-screen VRAM)
 *    '8' (four-screen and vertical bits on, primarily for mapper 218)
 *    Default is 'H'
 *    Example: #define NES2_MIRROR 'V'
 * 
 * - NES2_TV
 *    Sets the ROM's intended TV system:
 *    'N' for NTSC NES/FC/PC10
 *    'P' for PAL NES
 *    '1' for dual compatible, preferring NTSC
 *    '2' for dual compatible, preferring PAL NES
 *    Default is 'N'
 *    Example: #define NES2_TV '1'
 * 
 * Original ca65 macro Copyright 2016 Damian Yerrick
 * https://wiki.nesdev.org/w/index.php?title=NES_2.0_header_for_ca65
 * 
 * cc65 macro Copyright 2022 James Rowe
 * Copying and distribution of this file, with or without
 * modification, are permitted in any medium without royalty provided
 * the copyright notice and this notice are preserved in all source
 * code copies.  This file is offered as-is, without any warranty.
 * 
 */

#ifndef NES_P_H
#define NES_P_H

#ifndef NES2_SUBMAPPER
  #define NES2_SUBMAPPER 0x0
#endif //NES2_SUBMAPPER

// Define the bytes for the mapper fields
#define _NES2_MAPPER6 (((NES2_MAPPER) & 0x0F) << 4)
#define _NES2_MAPPER7 ((NES2_MAPPER) & 0xF0)
#define _NES2_MAPPER8 (((NES2_MAPPER) >> 8) | ((NES2_SUBMAPPER) << 4))

#define _NES2_PRG_SIZE (((NES2_PRG) / 16384) & 0xFF)
#define _NES2_PRG_SIZE_HI ((((NES2_PRG) / 16384) >> 8) & 0xFF)

// Define the defaults for the constants
#ifdef NES2_CHR
  #define _NES2_CHR_SIZE (((NES2_CHR) / 8192) & 0xFF)
  #define _NES2_CHR_SIZE_HI ((((NES2_CHR) / 8192) >> 8) & 0xFF)
#else
  #define _NES2_CHR_SIZE 0
  #define _NES2_CHR_SIZE_HI 0
#endif //NES2_CHR_SIZE

// Helper function: Computes ceil(log2(sz / 64)) Used for NES2 RAM sizes.
#define _NES2_ERROR -1
#define _NES2_LOGSIZE(sz) \
  (((sz) < 1L)       ? 0  : \
   ((sz) <= 128L)    ? 1  : \
   ((sz) <= 256L)    ? 2  : \
   ((sz) <= 512L)    ? 3  : \
   ((sz) <= 1024L)   ? 4  : \
   ((sz) <= 2048L)   ? 5  : \
   ((sz) <= 4096L)   ? 6  : \
   ((sz) <= 8192L)   ? 7  : \
   ((sz) <= 16384L)  ? 8  : \
   ((sz) <= 32768L)  ? 9  : \
   ((sz) <= 65536L)  ? 10 : \
   ((sz) <= 131072L) ? 11 : \
   ((sz) <= 262144L) ? 12 : \
   ((sz) <= 524288L) ? 13 : \
   ((sz) <= 1048576L)? 14 : _NES2_ERROR)

#define _NES2_MIRROR_HELPER(x) \
    (((x) == 'h' || (x) == 'H') ? 0 : \
     ((x) == 'v' || (x) == 'V') ? 1 : \
     ((x) == '4') ? 8 : \
     ((x) == '8') ? 9 : _NES2_ERROR)

#ifdef NES2_MIRROR
  #define _NES2_MIRROR_OUT (_NES2_MIRROR_HELPER(NES2_MIRROR))
#else
  #define _NES2_MIRROR_OUT (_NES2_MIRROR_HELPER('H'))
#endif //NES2_MIRROR

#ifdef NES2_WRAM
  #define _NES2_WRAM_SIZE (_NES2_LOGSIZE(NES2_WRAM))
#else
  #define _NES2_WRAM_SIZE (_NES2_LOGSIZE(0))
#endif //NES2_WRAM

#ifdef NES2_BRAM
  #define _NES2_BRAM_SIZE (_NES2_LOGSIZE(NES2_BRAM))
#else
  #define _NES2_BRAM_SIZE (_NES2_LOGSIZE(0))
#endif //NES2_BRAM

#ifdef NES2_CHRBRAM
  #define _NES2_CHRBRAM_SIZE (_NES2_LOGSIZE(NES2_CHRBRAM))
#else
  #define _NES2_CHRBRAM_SIZE (_NES2_LOGSIZE(0))
#endif //NES2_CHRBRAM

#ifdef NES2_CHRRAM
  #define _NES2_CHRRAM_SIZE (_NES2_LOGSIZE(NES2_CHRRAM))
#else
  // CHRRAM size depends on if the mapper has CHRBRAM or CHR already defined 
#define _NES2_CHRRAM_SIZE \
  ((((_NES2_CHR_SIZE) + _NES2_CHR_SIZE_HI + (_NES2_CHRBRAM_SIZE)) > 0) ? 0 : _NES2_LOGSIZE(32768L))
#endif

// Battery bit is set if we have either BRAM or CHRBRAM
#define _NES2_BATTERY_BIT \
  ((((_NES2_BRAM_SIZE) + (_NES2_CHRBRAM_SIZE)) > 0) ? 0x02 : 0x0)

#define _NES2_TV_HELPER(x) \
    (((x) == 'n' || (x) == 'N') ? 0 : \
     ((x) == 'p' || (x) == 'P') ? 1 : \
     ((x) == '1') ? 2 : \
     ((x) == '2') ? 3 : -1)

#ifdef NES2_TV
  #define _NES2_TV_SYSTEM _NES2_TV_HELPER(NES2_TV)
#else
  #define _NES2_TV_SYSTEM _NES2_TV_HELPER('N')
#endif //NES2_TV

#define NES2_HEADER() \
  _Static_assert (_NES2_WRAM_SIZE != _NES2_ERROR, "WRAM size must be 0 to 1048576"); \
  _Static_assert (_NES2_BRAM_SIZE != _NES2_ERROR, "BRAM size must be 0 to 1048576"); \
  _Static_assert (_NES2_CHRBRAM_SIZE != _NES2_ERROR, "CHRBRAM size must be 0 to 1048576"); \
  _Static_assert (_NES2_MIRROR_OUT != _NES2_ERROR, "Mirroring mode must be 'H', 'V', '4', or '8'"); \
  _Static_assert (_NES2_TV_SYSTEM != _NES2_ERROR, "TV system must be 'N', 'P', '1', or '2'"); \
  const unsigned char nes2header[16] = {\
    'N', 'E', 'S', 0x1A,\
    _NES2_PRG_SIZE, _NES2_CHR_SIZE,\
    _NES2_MAPPER6 | _NES2_MIRROR_OUT | _NES2_BATTERY_BIT, \
    _NES2_MAPPER7 | 0x08, \
    _NES2_MAPPER8, \
    (_NES2_CHR_SIZE_HI << 4) | _NES2_PRG_SIZE_HI, \
    (_NES2_BRAM_SIZE << 4) | _NES2_WRAM_SIZE, \
    (_NES2_CHRBRAM_SIZE << 4) | _NES2_CHRRAM_SIZE, \
    _NES2_TV_SYSTEM, 0, 0, 0 \
  };

#endif //NES_P_H

Where is this from? I can't find Damian Yerrick's implementation in ca65. (RE: * Original ca65 macro Copyright 2016 Damian Yerrick )
Also, the _NES2_CHRRAM_SIZE seems to be incorrect. It should be converted with _NES2_LOGSIZE as well. And why not allow it to be user defined?
Edit: Thanks for posting this, should have started with that: I have something working in ca65 and this helped a lot.

The original can be found here: https://wiki.nesdev.org/w/index.php?title=NES_2.0_header_for_ca65

Also, the _NES2_CHRRAM_SIZE seems to be incorrect. It should be converted with _NES2_LOGSIZE as well. And why not allow it to be user defined?

Oops, I have a few updates I've added to this that I pushed to my repo here https://github.com/jroweboy/cnes/blob/cbf8b182314ec5450a242f6c3fbe05952ea1aeea/src/inc/nes2header.h#L148-L150

I went and updated the gist to the latest version with those fixes. Thanks for reminding me about this gist.

Thanks! I saw your cnes repo, but didn't realize this was in there.