README.rst
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
