On Mon, 12 Jan 2026 09:20:00 +0800 Shawn Lin <[email protected]> wrote:
> Rockchip platforms provide a 64x4 bytes debug FIFO to trace the > LTSSM history. Any LTSSM change will be recorded. It's userful > for debug purpose, for example link failure, etc. > > Signed-off-by: Shawn Lin <[email protected]> > --- > > Changes in v3: > - reorder variables(Mani) > - rename loop to i; rename en to enable(Mani) > - use FIELD_GET(Mani) > - add comment about how the FIFO works(Mani) > > Changes in v2: > - use tracepoint > > drivers/pci/controller/dwc/pcie-dw-rockchip.c | 104 > ++++++++++++++++++++++++++ > 1 file changed, 104 insertions(+) > > diff --git a/drivers/pci/controller/dwc/pcie-dw-rockchip.c > b/drivers/pci/controller/dwc/pcie-dw-rockchip.c > index 352f513..344e0b9 100644 > --- a/drivers/pci/controller/dwc/pcie-dw-rockchip.c > +++ b/drivers/pci/controller/dwc/pcie-dw-rockchip.c > @@ -22,6 +22,8 @@ > #include <linux/platform_device.h> > #include <linux/regmap.h> > #include <linux/reset.h> > +#include <linux/workqueue.h> > +#include <trace/events/pci_controller.h> > > #include "../../pci.h" > #include "pcie-designware.h" > @@ -73,6 +75,20 @@ > #define PCIE_CLIENT_CDM_RASDES_TBA_L1_1 BIT(4) > #define PCIE_CLIENT_CDM_RASDES_TBA_L1_2 BIT(5) > > +/* Debug FIFO information */ > +#define PCIE_CLIENT_DBG_FIFO_MODE_CON 0x310 > +#define PCIE_CLIENT_DBG_EN 0xffff0007 > +#define PCIE_CLIENT_DBG_DIS 0xffff0000 > +#define PCIE_CLIENT_DBG_FIFO_PTN_HIT_D0 0x320 > +#define PCIE_CLIENT_DBG_FIFO_PTN_HIT_D1 0x324 > +#define PCIE_CLIENT_DBG_FIFO_TRN_HIT_D0 0x328 > +#define PCIE_CLIENT_DBG_FIFO_TRN_HIT_D1 0x32c > +#define PCIE_CLIENT_DBG_TRANSITION_DATA 0xffff0000 > +#define PCIE_CLIENT_DBG_FIFO_STATUS 0x350 > +#define PCIE_DBG_FIFO_RATE_MASK GENMASK(22, 20) > +#define PCIE_DBG_FIFO_L1SUB_MASK GENMASK(10, 8) > +#define PCIE_DBG_LTSSM_HISTORY_CNT 64 > + > /* Hot Reset Control Register */ > #define PCIE_CLIENT_HOT_RESET_CTRL 0x180 > #define PCIE_LTSSM_APP_DLY2_EN BIT(1) > @@ -96,6 +112,7 @@ struct rockchip_pcie { > struct irq_domain *irq_domain; > const struct rockchip_pcie_of_data *data; > bool supports_clkreq; > + struct delayed_work trace_work; > }; > > struct rockchip_pcie_of_data { > @@ -206,6 +223,89 @@ static enum dw_pcie_ltssm rockchip_pcie_get_ltssm(struct > dw_pcie *pci) > return rockchip_pcie_get_ltssm_reg(rockchip) & PCIE_LTSSM_STATUS_MASK; > } > > +#ifdef CONFIG_TRACING > +static void rockchip_pcie_ltssm_trace_work(struct work_struct *work) > +{ > + struct rockchip_pcie *rockchip = container_of(work, struct > rockchip_pcie, > + trace_work.work); > + struct dw_pcie *pci = &rockchip->pci; > + enum dw_pcie_ltssm state; > + u32 i, l1ss, prev_val = DW_PCIE_LTSSM_UNKNOWN, rate, val; > + > + for (i = 0; i < PCIE_DBG_LTSSM_HISTORY_CNT; i++) { > + val = rockchip_pcie_readl_apb(rockchip, > PCIE_CLIENT_DBG_FIFO_STATUS); > + rate = FIELD_GET(PCIE_DBG_FIFO_RATE_MASK, val); > + l1ss = FIELD_GET(PCIE_DBG_FIFO_L1SUB_MASK, val); > + val = FIELD_GET(PCIE_LTSSM_STATUS_MASK, val); > + > + /* > + * Hardware Mechanism: The ring FIFO employs two tracking > counters: > + * - 'last-read-point': maintains the user's last read position > + * - 'last-valid-point': tracks the hardware's last state update > + * > + * Software Handling: When two consecutive LTSSM states are > identical, > + * it indicates invalid subsequent data in the FIFO. In this > case, we > + * skip the remaining entries. The dual-counter design ensures > that on > + * the next state transition, reading can resume from the last > user > + * position. > + */ > + if ((i > 0 && val == prev_val) || val > DW_PCIE_LTSSM_RCVRY_EQ3) > + break; > + > + state = prev_val = val; > + if (val == DW_PCIE_LTSSM_L1_IDLE) { > + if (l1ss == 2) > + state = DW_PCIE_LTSSM_L1_2; > + else if (l1ss == 1) > + state = DW_PCIE_LTSSM_L1_1; > + } > + > + trace_pcie_ltssm_state_transition(dev_name(pci->dev), > + dw_pcie_ltssm_status_string(state), > + ((rate + 1) > pci->max_link_speed) ? > + PCI_SPEED_UNKNOWN : PCIE_SPEED_2_5GT + > rate); > + } Does it make sense to call this work function every 5 seconds when the tracepoint isn't enabled? You can add a function callback to when the tracepoint is enabled by defining: TRACE_EVENT_FN(<name> TP_PROTO(..) TP_ARGS(..) TP_STRUCT__entry(..) TP_fast_assign(..) TP_printk(..) reg, unreg) reg() gets called when the tracepoint is first enabled. This could be where you can start the work function. And unreg() would stop it. You would likely need to also include state variables as I guess you don't want to start it if the link is down. Also, if the tracepoint is enabled when the link goes up you want to start the work queue. I would recommend this so that you don't call this work function when it's not doing anything useful. -- Steve > + > + schedule_delayed_work(&rockchip->trace_work, msecs_to_jiffies(5000)); > +} > +
