WIP: device tree MVP

2026-11-13 13:51:36 +08:00 · 2022-01-06 17:20:17 -05:00
parent 07d75d85cf
commit 1f39b42525
1395 changed files with 68755 additions and 0 deletions
@@ -0,0 +1,78 @@
+# Copyright (C) 2020 Nordic Semiconductor ASA
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+    Description of pre-defined file systems.
+
+compatible: "zephyr,fstab,littlefs"
+
+include: "zephyr,fstab-common.yaml"
+
+properties:
+  # num-files and num-dirs are not filesystem-specific.
+
+  read-size:
+    type: int
+    required: true
+    description: |
+      The size of file system read operations, in bytes.
+
+      All read operations will be a multiple of this value.  A
+      reasonable default is 16.
+
+      This corresponds to CONFIG_FS_LITTLEFS_READ_SIZE.
+
+  prog-size:
+    type: int
+    required: true
+    description: |
+      The size of file system program (write) operations, in bytes.
+
+      All program operations will be a multiple of this value.  A
+      reasonable default is 16.
+
+      This corresponds to CONFIG_FS_LITTLEFS_PROG_SIZE.
+
+  cache-size:
+    type: int
+    required: true
+    description: |
+      The size of block caches, in bytes.
+
+      Each cache buffers a portion of a block in RAM.  The littlefs
+      needs a read cache, a program cache, and one additional cache per
+      file. Larger caches can improve performance by storing more data
+      and reducing the number of disk accesses. Must be a multiple of
+      the read and program sizes of the underlying flash device, and a
+      factor of the block size.
+
+      A reasonable default is 64.
+
+      This corresponds to CONFIG_FS_LITTLEFS_CACHE_SIZE.
+
+  lookahead-size:
+    type: int
+    required: true
+    description: |
+      The size of the lookahead buffer, in bytes.
+
+      A larger lookahead buffer increases the number of blocks found
+      during an allocation pass. The lookahead buffer is stored as a
+      compact bitmap, so each byte of RAM can track 8 blocks. Must be a
+      multiple of 8.
+
+      A reasonable default is 32.
+
+      This corresponds to CONFIG_FS_LITTLEFS_LOOKAHEAD_SIZE.
+
+  block-cycles:
+    type: int
+    required: true
+    description: |
+      The number of erase cycles before moving data to another block.
+
+      For dynamic wear leveling, the number of erase cycles before data
+      is moved to another block.  Set to a non-positive value to disable
+      leveling.
+
+      This corresponds to CONFIG_FS_LITTLEFS_LOOKAHEAD_SIZE.
@@ -0,0 +1,51 @@
+# Copyright (C) 2020 Nordic Semiconductor ASA
+# SPDX-License-Identifier: Apache-2.0
+
+# Common properties for Zephyr filesystem compatibles
+
+include: base.yaml
+
+properties:
+  mount-point:
+    type: string
+    required: true
+    description: |
+      The absolute path used as the file system mount point.
+
+  partition:
+    type: phandle
+    required: true
+    description: |
+      A reference to the file system's partition.
+
+  automount:
+    type: boolean
+    description: |
+      Mount file system on boot if present.
+
+      During initialization the file system driver will attempt to mount
+      this partition.
+
+  read-only:
+    type: boolean
+    description: |
+      Mount file system read-only if present.
+
+      This adds the FS_MOUNT_FLAG_READ_ONLY option to be set in the
+      mount descriptor generated for the file system.
+
+  no-format:
+    type: boolean
+    description: |
+      Do not format file system if mount fails.
+
+      This causes the FS_MOUNT_FLAG_NO_FORMAT option to be set in the
+      mount descriptor generated for the file system.
+
+  disk-access:
+    type: boolean
+    description: |
+      Use disk-access for accessing storage media.
+
+      This causes the FS_MOUNT_FLAG_USE_DISK_ACCESS option to be set in
+      the mount descriptor generated for the file system.
@@ -0,0 +1,12 @@
+# Copyright (C) 2020 Nordic Semiconductor ASA
+# SPDX-License-Identifier: Apache-2.0
+
+description: |
+    Description of pre-defined file systems.
+
+    This is a container for child nodes that provide at minimum the
+    properties described in zephyr,fstab-common.yaml.
+
+compatible: "zephyr,fstab"
+
+include: base.yaml