Module-private link seam shared between the MIPI D-PHY drivertranslation units. More...

#include <stdint.h>
#include "ra8_attributes.h"
#include "ra8_mipi_phy.h"

Include dependency graph for ra8_mipi_phy_internal.h:

This graph shows which files directly or indirectly include this file:

Functions
void	priv_mipi_phy_write_timing (const ra8_mipi_phy_timing_t *t)
	Write the six DPHYTIMx registers from the timing block.
uint32_t	priv_mipi_phy_compute_freq (const ra8_mipi_phy_pll_t *pll, uint8_t mosc_mhz)
	Compute the PLL output frequency for a (mosc, pll) tuple.

Detailed Description

Module-private link seam shared between the MIPI D-PHY driver

translation units.

Tag: [Ring 3 / HAL] {World: NS}

The MIPI D-PHY driver is implemented across more than one translation unit so that no single file exceeds the scripts/checks/check_file_size.py cap. The lifecycle / power / mode / lane / status / IRQ path lives in ra8_mipi_phy.c; the bulky HUM Tables 64.2 (DSI) / 64.3 (CSI) timing matrix, its lookup walker, the PLL-frequency arithmetic helper, and the ra8_mipi_phy_select_timing surface live in ra8_mipi_phy_timing.c. Two helper functions are called across the two TUs and are declared here.

This header is private to the MIPI D-PHY driver only – no other module includes it. It exports:

priv_mipi_phy_write_timing: defined in ra8_mipi_phy.c and used by the table-driven ra8_mipi_phy_select_timing in ra8_mipi_phy_timing.c;
priv_mipi_phy_compute_freq: defined in ra8_mipi_phy_timing.c and used by ra8_mipi_phy_validate_pll_band in ra8_mipi_phy.c.

Read-only constants (the log tag) and the file-scope mutable driver state are intentionally NOT shared: each is confined to the single TU that uses it.

Copyright: Copyright (c) 2026 Brighton Sikarskie SPDX-License-Identifier: MIT

Since: 0.1.0

Definition in file ra8_mipi_phy_internal.h.

Function Documentation

◆ priv_mipi_phy_compute_freq()

uint32_t priv_mipi_phy_compute_freq	(	const ra8_mipi_phy_pll_t *	pll,
		uint8_t	mosc_mhz )

Compute the PLL output frequency for a (mosc, pll) tuple.

Defined in ra8_mipi_phy_timing.c and shared with ra8_mipi_phy_validate_pll_band in ra8_mipi_phy.c. Implements the HUM Ch 64.2.2 p 3823 relation f = fMAIN * I * (NF + N) * P using hundredths fixed-point arithmetic.

Parameters

[in]	pll	PLL coefficient block (IDIV / NFMUL / PMUL / NMUL).
[in]	mosc_mhz	Main-oscillator frequency in MHz.

Returns: PLL output frequency in MHz, or 0 if the divisor product is 0.

Return values

0	The composed divisor product was zero.
other	Computed PLL output frequency in MHz.

Precondition: pll is a valid, non-NULL ra8_mipi_phy_pll_t.; mosc_mhz is a non-zero main-oscillator frequency.

Postcondition: No register or shared state is modified by this helper.; The return value is a pure function of the two arguments.

Note: Internal helper. Not thread-safe; caller provides synchronisation.

Since: 0.1.0

Definition at line 880 of file ra8_mipi_phy_timing.c.

References ra8_mipi_phy_pll_t::idiv, k_mipi_nf_x100_33, k_mipi_nf_x100_50, k_mipi_nf_x100_66, k_mipi_pll_percent_scale, ra8_mipi_phy_pll_t::nfmul, ra8_mipi_phy_pll_t::nmul_int, and ra8_mipi_phy_pll_t::pmul.

Referenced by ra8_mipi_phy_validate_pll_band().

◆ priv_mipi_phy_write_timing()

void priv_mipi_phy_write_timing ( const ra8_mipi_phy_timing_t * t )

Write the six DPHYTIMx registers from the timing block.

Defined in ra8_mipi_phy.c and shared with the table-driven ra8_mipi_phy_select_timing in ra8_mipi_phy_timing.c. Programs DPHYTIM1..DPHYTIM6 (HUM Ch 64.2.8 - 64.2.13 p 3827-3830) from the caller-supplied timing snapshot.

Parameters

[in] t Timing block whose fields are packed into DPHYTIM1..6.

Precondition: t is a valid, non-NULL ra8_mipi_phy_timing_t.; The MIPI PHY module clock is ungated.

Postcondition: DPHYTIM1..DPHYTIM6 reflect the fields of *t.; No register other than DPHYTIM1..6 is modified.

Note: Internal helper. Not thread-safe; caller provides synchronisation.

Since: 0.1.0

Write the six DPHYTIMx registers from the timing block.

Definition at line 248 of file ra8_mipi_phy.c.

References k_ra8_mipi_phy_off_tim1, k_ra8_mipi_phy_off_tim2, k_ra8_mipi_phy_off_tim3, k_ra8_mipi_phy_off_tim4, k_ra8_mipi_phy_off_tim5, k_ra8_mipi_phy_off_tim6, k_ra8_mipi_phy_tim1_tinit_mask, k_ra8_mipi_phy_tim6_tlpx_mask, k_ra8_mipi_phy_tim_byte_mask, k_ra8_mipi_phy_tim_shift_b0, k_ra8_mipi_phy_tim_shift_b1, k_ra8_mipi_phy_tim_shift_b2, k_ra8_mipi_phy_tim_shift_b3, ra8_mipi_phy_reg32(), ra8_mipi_phy_timing_t::tclkmiss, ra8_mipi_phy_timing_t::tclkpost, ra8_mipi_phy_timing_t::tclkpre, ra8_mipi_phy_timing_t::tclkprep, ra8_mipi_phy_timing_t::tclksett, ra8_mipi_phy_timing_t::tclktrl, ra8_mipi_phy_timing_t::tclkzero, ra8_mipi_phy_timing_t::thsexit, ra8_mipi_phy_timing_t::thsprep, ra8_mipi_phy_timing_t::thssett, ra8_mipi_phy_timing_t::thstrl, ra8_mipi_phy_timing_t::thszero, ra8_mipi_phy_timing_t::tinit, and ra8_mipi_phy_timing_t::tlpx.

Referenced by ra8_mipi_phy_init(), and ra8_mipi_phy_select_timing().

Functions

Detailed Description

Function Documentation

◆ priv_mipi_phy_compute_freq()

◆ priv_mipi_phy_write_timing()