pgngen

type EnumDef struct {
	Name   string
	Values []EnumValue
	Line   int // source line for error reporting
}

type EnumValue struct {
	Value int
	Name  string
}

type FieldDef struct {
	Name        string    // empty for reserved fields ("_")
	Type        FieldType // base type
	Bits        int       // bit width
	BitStart    int       // computed bit offset from start of packet (set by Resolve)
	Scale       float64   // raw * scale = decoded (0 means no scaling)
	Offset      float64   // decoded = raw * scale + offset (0 means no offset)
	Unit        string    // human-readable unit (e.g. "deg", "m/s")
	Desc        string    // optional description
	EnumRef     string    // enum type name (non-empty when Type == TypeEnum)
	LookupRef   string    // lookup table name (non-empty when lookup= is set)
	StructRef   string    // struct type name (non-empty when Type == TypeStruct)
	RepeatRef   string    // dynamic repeat count field name (e.g. "sats_in_view")
	Trim        string    // characters to right-trim from decoded string (e.g. "@ ")
	Tolerance   *float64  // change detection tolerance (nil = not set, 0 = any change significant)
	Signed      bool      // true for int types
	MatchValue  *int64    // when set, this field must equal this value (dispatch discriminator)
	RepeatCount int       // number of repetitions (0 = not repeated, must be >= 2 when set)
	GroupMode   string    // "" (array, default) or "map" (map[int]T)
	AliasPlural string    // override for auto-pluralized field name (from as= attribute)
	PGNRef      string    // field name holding the target PGN for cross-PGN pair decoding (bytes fields only)
	CountRef    string    // field name holding the number of parameter pairs (bytes fields only)
	Line        int       // source line for error reporting
}

type FieldType int

type LookupDef struct {
	Name    string // e.g. "VictronRegister"
	KeyType string // Go type: "uint8", "uint16", "uint32", "uint64"
	Values  []LookupValue
	Line    int // source line for error reporting
}

type LookupValue struct {
	Key  int64
	Name string
}

type PGNDef struct {
	PGN         uint32
	Description string
	FastPacket  bool
	Interval    time.Duration // 0 = unspecified
	OnDemand    bool
	Draft       bool // definition is incomplete or uncertain
	Fields      []FieldDef
	Line        int // source line for error reporting
}

type ResolveError struct {
	Line    int
	Message string
}

type Schema struct {
	Enums   []EnumDef
	Lookups []LookupDef
	Structs []StructDef
	PGNs    []PGNDef
}

type StructDef struct {
	Name   string     // snake_case (e.g. "satellite_in_view")
	Fields []FieldDef // field layout within each entry
	Line   int        // source line for error reporting
}