clock_diag.h

/*NB_REVISION*/
 
/*NB_COPYRIGHT*/
 
/* clock_diag.h - read-only HyperRAM (FlexSPI) clock and RX-tap diagnostics.
 *
 * The SOMRT1061 boot monitor owns the HyperRAM clock and the DLL RX sampling
 * tap (it calibrates the tap at first boot and applies it on every boot).
 * This module makes no changes to either - it only decodes the live CCM and
 * FlexSPI registers so the values can be reported:
 *
 *   - on the config server's Diagnostics tab (:20034/DIAG, entry
 *     "HyperRamClock"), and
 *   - as a one-line boot report via ClockDiagPrint().
 */
#ifndef CLOCK_DIAG_H
#define CLOCK_DIAG_H
#include <stdint.h>
 
/* Live HyperRAM interface state, decoded from the clock tree and DLLCR. */
struct HyperRamClockInfo
{
    uint32_t sckHz;     // HyperRAM DDR serial clock
    uint32_t pfd2Frac;  // PFD_528.PFD2_FRAC field value
    uint32_t tap;       // RX sampling tap (override tap, or live auto tap)
    bool     ovrd;      // true = fixed override tap
    bool     dllen;     // DLL machinery enabled
    uint32_t dllcr;     // raw DLLCR[0]
};
 
void GetHyperRamClockInfo(HyperRamClockInfo *out);
 
/* One-line console report: SCK and RX tap. */
void ClockDiagPrint(void);
 
#endif /* CLOCK_DIAG_H */