1.. zephyr:code-sample:: jesd216
2   :name: JESD216 flash
3   :relevant-api: flash_interface
4
5   Use the JESD216 flash API to extract information from a compatible serial memory device.
6
7Overview
8********
9
10This sample demonstrates how to use the JESD216 flash API to extract
11information from a compatible serial device, and serves as utility to
12generate ``jedec,spi-nor`` devicetree property values for the device.
13
14Building and Running
15********************
16
17The application will build only for a target that has a devicetree entry
18with ``jedec,spi-nor`` as a compatible, and for which the driver
19supports :kconfig:option:`CONFIG_FLASH_JESD216_API`.
20
21.. zephyr-app-commands::
22   :zephyr-app: samples/drivers/jesd216
23   :board: sltb004a
24   :goals: build flash
25   :compact:
26
27Sample Output
28=============
29
30.. code-block:: console
31
32   MX25R8035F: SFDP v 1.6 AP ff with 3 PH
33   PH0: ff00 rev 1.6: 16 DW @ 30
34   Summary of BFP content:
35   DTR Clocking not supported
36   Addressing: 3-Byte only
37   4-KiBy erase: uniform
38   Support QSPI XIP
39   Support 1-1-1
40   Support 1-1-2: instr 3Bh, 0 mode clocks, 8 waits
41   Support 1-1-4: instr 6Bh, 0 mode clocks, 8 waits
42   Support 1-2-2: instr BBh, 0 mode clocks, 4 waits
43   Support 1-4-4: instr EBh, 2 mode clocks, 4 waits
44   Flash density: 1048576 bytes
45   ET1: instr 20h for 4096 By; typ 48 ms, max 384 ms
46   ET2: instr 52h for 32768 By; typ 240 ms, max 1920 ms
47   ET3: instr D8h for 65536 By; typ 480 ms, max 3840 ms
48   Chip erase: typ 6144 ms, max 36864 ms
49   Byte program: type 32 + 1 * B us, max 192 + 6 * B us
50   Page program: typ 896 us, max 5376 us
51   Page size: 256 By
52   Suspend: B0h ; Resume: 30h
53   DPD: Enter B9h, exit ABh ; delay 40000 ns ; poll 0x3d
54   size = <8388608>;
55   sfdp-bfp = [
56           e5 20 f1 ff  ff ff 7f 00  44 eb 08 6b  08 3b 04 bb
57           ee ff ff ff  ff ff 00 ff  ff ff 00 ff  0c 20 0f 52
58           10 d8 00 ff  23 72 f5 00  82 ed 04 b7  44 83 38 44
59           30 b0 30 b0  f7 c4 d5 5c  00 be 29 ff  f0 d0 ff ff
60           ];
61   PH1: ffc2 rev 1.0: 4 DW @ 110
62   sfdp-ffc2 = [
63           00 36 50 16  9d f9 c0 64  fe cf ff ff  ff ff ff ff
64           ];
65   PH2: ff84 rev 1.0: 2 DW @ c0
66   sfdp-ff84 = [
67           00 00 f0 ff  ff ff ff ff
68           ];
69   jedec-id = [c2 28 14];
70