README.rst
1.. zephyr:code-sample:: mspi-timing-scan
2 :name: Ambiq MSPI timing scan
3 :relevant-api: flash_interface
4
5 Find the appropriate timing for a given device on a given board.
6
7Overview
8********
9
10This sample demonstrates the usage of ambiq timing scan utility.
11
12Building and Running
13********************
14
15The application will build only for a target that has a :ref:`devicetree <dt-guide>`
16``flash0`` or ``psram0`` alias depending on the interface used.
17They refers to an entry with the following bindings as a compatible:
18
19* :dtcompatible:`ambiq,mspi-device`
20
21.. zephyr-app-commands::
22 :zephyr-app: samples/drivers/mspi/mspi_timing_scan
23 :board: apollo5_eb
24 :goals: build flash
25 :compact:
26
27Sample Output
28=============
29
30.. code-block:: console
31
32 *** Booting Zephyr OS build zephyr-v3.4.0-27775-g750ed00d564b ***
33 <inf> mspi_ambiq_timing_scan: TxNeg=0, RxNeg=0, RxCap=0, Turnaround=5
34 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 0, RxDQSDelay Scan = 0x0007FFFE, Window size = 18
35 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 1, RxDQSDelay Scan = 0x0007FFFF, Window size = 19
36 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 1, RxDQSDelay Scan = 0x0007FFFF, Window size = 19
37 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 2, RxDQSDelay Scan = 0x0007FFFE, Window size = 18
38 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 3, RxDQSDelay Scan = 0x0007FFFF, Window size = 19
39 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 4, RxDQSDelay Scan = 0x0007FFFE, Window size = 18
40 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 5, RxDQSDelay Scan = 0x0005FD54, Window size = 7
41 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 6, RxDQSDelay Scan = 0x00000000, Window size = 0
42 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 7, RxDQSDelay Scan = 0x00000000, Window size = 0
43 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 8, RxDQSDelay Scan = 0x00000000, Window size = 0
44 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 9, RxDQSDelay Scan = 0x00000000, Window size = 0
45 <inf> mspi_ambiq_timing_scan: TxDQSDelay: 10, RxDQSDelay Scan = 0x00000000, Window size = 0
46 <inf> mspi_ambiq_timing_scan: Selected setting: TxNeg=0, RxNeg=0, RxCap=0, Turnaround=5,TxDQSDelay=2, RxDQSDelay=9
47