All files / transpiler/output/codegen/generators/declarationGenerators RegisterMacroGenerator.ts

100% Statements 15/15
100% Branches 6/6
100% Functions 1/1
100% Lines 15/15

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65                                                                27x   27x 38x 38x 38x 38x     38x 12x 12x 1x         38x 38x 6x       38x         27x        
/**
 * RegisterMacroGenerator - Shared logic for register #define macro generation
 *
 * Extracts common logic from RegisterGenerator and ScopedRegisterGenerator
 * for generating C #define macros from C-Next register members.
 */
import * as Parser from "../../../../logic/parser/grammar/CNextParser";
import IOrchestrator from "../IOrchestrator";
 
/**
 * Optional type resolver for scoped types.
 * Returns resolved type name if found, undefined to use original type.
 */
type TTypeResolver = (originalType: string) => string | undefined;
 
/**
 * Generate #define macros for register members.
 *
 * @param members - Register member declarations from AST
 * @param prefix - Prefix for macro names (e.g., "GPIO7" or "Teensy4_GPIO7")
 * @param baseAddress - Base address expression string
 * @param orchestrator - Code generation orchestrator
 * @param typeResolver - Optional callback to resolve scoped types
 * @returns Array of #define lines
 */
function generateRegisterMacros(
  members: Parser.RegisterMemberContext[],
  prefix: string,
  baseAddress: string,
  orchestrator: IOrchestrator,
  typeResolver?: TTypeResolver,
): string[] {
  const lines: string[] = [];
 
  for (const member of members) {
    const regName = member.IDENTIFIER().getText();
    let regType = orchestrator.generateType(member.type());
    const access = member.accessModifier().getText();
    const offset = orchestrator.generateExpression(member.expression());
 
    // Apply optional type resolution (for scoped bitmaps)
    if (typeResolver) {
      const resolved = typeResolver(regType);
      if (resolved) {
        regType = resolved;
      }
    }
 
    // Determine qualifiers based on access mode
    let cast = `volatile ${regType}*`;
    if (access === "ro") {
      cast = `volatile ${regType} const *`;
    }
 
    // Generate: #define PREFIX_REGNAME (*(volatile type*)(base + offset))
    lines.push(
      `#define ${prefix}_${regName} (*(${cast})(${baseAddress} + ${offset}))`,
    );
  }
 
  return lines;
}
 
export default generateRegisterMacros;