This message will disappear after all relevant tasks have been resolved.
Semantic MediaWiki
There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.deleted>Frq08988 m (moved Linux directory structure to OpenSTLinux directory structure: Dedicated to OpenSTLinux) |
Registered User mNo edit summary |
||
| (23 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
<noinclude> | <noinclude>{{ApplicableFor | ||
{{ | |MPUs list=STM32MP13x, STM32MP15x | ||
|MPUs checklist=STM32MP13x, STM32MP15x | |||
}}</noinclude> | |||
This article aims at presenting, '''as example''', the directory structure of the Linux root file system available on STM32 board. | |||
</noinclude> | |||
This article aims at presenting the directory structure of the Linux root file system available on STM32 board. | |||
All files and directories are located under the root directory (''/''), in compliance with the [[File Hierarchy Standard (FHS)|File system Hierarchy Standard]]. | All files and directories are located under the root directory (''/''), in compliance with the [[File Hierarchy Standard (FHS)|File system Hierarchy Standard]]. | ||
This root directory corresponds to the Linux root file system (rootfs partition), as defined in [[ | This root directory corresponds to the Linux root file system (rootfs partition), as defined in [[STM32 MPU Flash mapping#Flash partitions|Flash partitions]]. Note also that the user file system (userfs partition), the boot file system (bootfs partition) and the vendor file system (vendorfs partition) can be accessed through the ''/usr/local'' mounting point, through the ''/boot'' mounting point, and through the ''/vendor'' mounting point respectively. | ||
{{info|In practice, this article uses the STM32MPU Embedded Software distribution | {{info|In practice, this article uses the release '''STM32MP15-Ecosystem-v{{EcosystemRelease/Revision | revision=latest}}''' for the STM32MPU Embedded Software distribution as an example to illustrate the Linux directory structure. If you are using a different release, the names of the directories and files might differ.}}{{UpdateNeededForNewRelease|The trees below shall be updated periodically, even if the information banner specifies that they might not be up-to-date}} | ||
The directories are shown in {{Green|green}}, while the files are in black. | The directories are shown in {{Green|green}}, while the files are in black. | ||
{{Green|/}} {{Highlight|'''Root directory (rootfs partition)'''}} | {{Green|/}} {{Highlight|'''Root directory (rootfs partition)'''}} | ||
├── {{Green|bin}} {{Highlight|Essential user binaries (e.g. ''/bin/cat'', ''/bin/ls'', ''/bin/cp''...)}} | ├── {{Green|bin}} {{Highlight|Essential user binaries (e.g. ''/bin/cat'', ''/bin/ls'', ''/bin/cp''...)}} | ||
│ └── [...] | │ └── [...] | ||
├── {{Green|boot}} {{Highlight|Mounting point for the boot file system (bootfs partition): see below}} | ├── {{Green|boot}} {{Highlight|Mounting point for the boot file system (bootfs partition): see below}} | ||
├── {{Green|dev}} {{Highlight|Device files (e.g. ''/dev/null'', ''/dev/tty0'', ''/dev/video0''...)}} | ├── {{Green|dev}} {{Highlight|Device files (e.g. ''/dev/null'', ''/dev/tty0'', ''/dev/video0''...)}} | ||
├── {{Green|etc}} {{Highlight|System-wide configuration files (e.g. ''/etc/xdg/weston/weston.ini'' Weston configuration file...)}} | ├── {{Green|etc}} {{Highlight|System-wide configuration files (e.g. ''/etc/xdg/weston/weston.ini'' Weston configuration file...)}} | ||
├── {{Green|home}} {{Highlight|Users' home directories (containing saved files, personal settings...)}} | ├── {{Green|home}} {{Highlight|Users' home directories (containing saved files, personal settings...)}} | ||
├── {{Green|lib}} {{Highlight|Essential system libraries for the binaries in ''/bin'' and ''/sbin'' (e.g. ''libncurses.so. | ├── {{Green|lib}} {{Highlight|Essential system libraries for the binaries in ''/bin'' and ''/sbin'' (e.g. ''libncurses.so.*''...)}} | ||
│ ├── {{Green|modules}} | │ ├── {{Green|modules}} | ||
│ │ └── {{Green| | │ │ └── ''{{Green|{{EcosystemRelease/Component | revision=latest | component=Linux kernel | name=release}}}}'' {{Highlight|The directory name is the linux version (i.e. {{EcosystemRelease/Component | revision=latest | component=Linux kernel | name=release}})}} | ||
│ │ ├── {{Green|kernel}} {{Highlight|Linux kernel modules}} | │ │ ├── {{Green|kernel}} {{Highlight|Linux kernel modules}} | ||
│ │ │ └── [...] | │ │ │ └── [...] | ||
| Line 34: | Line 28: | ||
├── {{Green|lost+found}} | ├── {{Green|lost+found}} | ||
├── {{Green|media}} {{Highlight|Mount points for removable media devices}} | ├── {{Green|media}} {{Highlight|Mount points for removable media devices}} | ||
├── {{Green|mnt}} {{Highlight|Temporarily mounted file systems}} | ├── {{Green|mnt}} {{Highlight|Temporarily mounted file systems}} | ||
├── {{Green|proc}} {{Highlight|[[Pseudo filesystem|Pseudo filesystem]] providing process and kernel information as files (e.g. ''/proc/cpuinfo'', ''/proc/version''...)}} | ├── {{Green|proc}} {{Highlight|[[Pseudo filesystem|Pseudo filesystem]] providing process and kernel information as files (e.g. ''/proc/cpuinfo'', ''/proc/version''...)}} | ||
├── {{Green|root}} {{Highlight|Home directory for the root user)}} | |||
├── {{Green|run}} {{Highlight|Run-time variable data (information about the running system since last boot)}} | ├── {{Green|run}} {{Highlight|Run-time variable data (information about the running system since last boot)}} | ||
├── {{Green|sbin}} {{Highlight|Essential system binaries (e.g. ''/sbin/fsck'', ''/sbin/init'', ''/sbin/modprobe''...)}} | ├── {{Green|sbin}} {{Highlight|Essential system binaries (e.g. ''/sbin/fsck'', ''/sbin/init'', ''/sbin/modprobe''...)}} | ||
| Line 48: | Line 42: | ||
│ ├── {{Green|share}} {{Highlight|Architecture-independent (shared) data}} | │ ├── {{Green|share}} {{Highlight|Architecture-independent (shared) data}} | ||
│ └── [...] | │ └── [...] | ||
├── {{Green|var}} {{Highlight|Variable files}} | |||
└── {{Green|vendor}} {{Highlight|Mounting point for the vendor file system (vendorfs partition): see below}} | |||
* Boot file system mounting point | * Boot file system mounting point | ||
{{Green|/boot}} {{Highlight|'''bootfs partition'''}} | {{Green|/boot}} {{Highlight|'''bootfs partition'''}} | ||
├── | ├── stm32mp157f-dk2[*].dtb {{Highlight|Linux kernel device tree blob files → STM32MP157F-DK2}} | ||
├── | ├── stm32mp157f-ev1[*].dtb {{Highlight|Linux kernel device tree blob files → STM32MP157F-EV1}} | ||
├── uImage | ├── uImage {{Highlight|Linux kernel binary image file (with U-Boot wrapper)}} | ||
└── [...] | └── [...] | ||
* User file system mounting point | * User file system mounting point | ||
{{Green|/usr/local}} {{Highlight|'''userfs partition'''}} | {{Green|/usr/local}} {{Highlight|'''userfs partition'''}} | ||
├── {{Green|examples}} | ├── {{Green|Cube-M4-examples}} {{Highlight|Examples for STM32CubeMP1 Package running on Arm<sup>®</sup> Cortex<sup>®</sup>-M4}} | ||
│ ├── {{Green| | │ ├── {{Green|STM32MP157C-DK2}} {{Highlight|Examples of firmwares running on Arm Cortex-M4 → STM32MP157C-DK2 (see more in [[STM32CubeMP1 Package]])}} | ||
│ │ ├── {{Green| | │ │ ├── {{Green|Applications}} | ||
│ │ │ ├── fw_cortex_m4.sh | │ │ │ ├── {{Green|OpenAMP}} | ||
│ │ │ ├── {{Green|lib}} | │ │ | | ├── {{Green|OpenAMP_TTY_echo}} {{Highlight|OpenAMP TTY echo application}} | ||
│ │ │ │ └── {{Green|firmware}} | │ │ │ | | ├── fw_cortex_m4.sh {{Highlight|Script to start/stop this application}} | ||
│ │ │ │ └── | │ │ │ | | ├── {{Green|lib}} | ||
│ │ │ └── README | │ │ │ | | │ └── {{Green|firmware}} | ||
│ │ | │ │ │ | | │ └── OpenAMP_TTY_echo.elf {{Highlight|Firmware for this application}} | ||
│ │ │ | | └── README {{Highlight|Helper file for this application}} | |||
│ │ │ ├── {{Green| | │ │ │ │ └── [...] {{Highlight|Other OpenAMP applications with the same structure (script, helper file and firmware)}} | ||
│ │ │ │ └── {{Green|firmware}} | │ │ │ └── [...] {{Highlight|Other applications with the same structure (script, helper file and firmware)}} | ||
│ │ │ | │ │ ├── {{Green|Demonstrations}} | ||
│ │ │ | │ │ │ ├── {{Green|AI_Character_Recognition}} {{Highlight|Artificial intelligence character recognition demonstration}} | ||
│ │ | │ │ │ └── {{Green|lib}} | ||
│ │ ├── fw_cortex_m4.sh | │ │ │ └── {{Green|firmware}} | ||
│ │ ├── {{Green|lib}} | │ │ │ └── AI_Character_Recognition.elf {{Highlight|Firmware for this demonstration}} | ||
│ │ │ └── {{Green|firmware}} | │ │ └── {{Green|Examples}} | ||
│ │ │ └── | │ │ ├── {{Green|GPIO}} | ||
│ │ └── README | │ │ | └── {{Green|GPIO_EXTI}} {{Highlight|GPIO EXTI example}} | ||
│ │ | ├── fw_cortex_m4.sh {{Highlight|Script to start/stop this example}} | |||
│ │ | ├── {{Green|lib}} | |||
│ │ | │ └── {{Green|firmware}} | |||
│ │ | │ └── GPIO_EXTI.elf {{Highlight|Firmware for this example}} | |||
│ │ | └── README {{Highlight|Helper file for this example}} | |||
│ │ └── [...] {{Highlight|Other examples with the same structure (script, helper file and firmware)}} | |||
│ └── {{Green|STM32MP157C-EV1}} {{Highlight|Examples of firmwares running on Arm Cortex-M4 → STM32MP157C-EV1 (see more in [[STM32CubeMP1 Package]])}} | |||
│ ├── {{Green|Applications}} | |||
│ │ └── [...] {{Highlight|Applications with the same structure (script, helper file and firmware)}} | |||
│ ├── {{Green|Demonstrations}} | |||
│ │ └── [...] {{Highlight|Demonstrations with the same structure (script, helper file and firmware)}} | |||
│ └── {{Green|Examples}} | |||
│ └── [...] {{Highlight|Examples with the same structure (script, helper file and firmware)}} | |||
├── {{Green|Linux-A7-examples}} {{Highlight|Examples for Linux<sup>®</sup> running on Arm<sup>®</sup> Cortex<sup>®</sup>-A7}} | |||
│ | │ ├── {{Green|GPIO}} {{Highlight|GPIO examples}} | ||
│ │ ├── {{Green|buttons}} | |||
│ │ │ ├── button_gpio_exti.sh {{Highlight|Script for this example}} | |||
│ │ | └── README.md {{Highlight|Helper file for this example}} | |||
│ │ └── {{Green|leds}} {{Highlight|Same structure for this example relative to the leds}} | |||
│ | │ │ └── [...] | ||
│ | │ └── [...] {{Highlight|Same structure for all the examples}} | ||
├── {{Green|demo}} {{Highlight|All files needed (e.g. Python scripts, pictures, media files...) for the GTK demo launcher}} | |||
│ └── [...] | |||
├── {{Green|lost+found}} | |||
└── {{Green|weston-start-at-startup}} | |||
└── start_up_demo_launcher.sh {{Highlight|Script to start the GTK demo launcher}} | |||
* Vendor file system mounting point | |||
{{Green|/vendor}} {{Highlight|'''vendorfs partition'''}} | |||
├── [*].so {{Highlight|Specific vendor libraries (e.g. Vivante libraries OpenGL ES, OpenVG and EGL)}} | |||
└── [...] | |||
<noinclude> | |||
[[Category:OpenSTLinux filesystem]] | |||
{{PublicationRequestId | 7653 | 2018-06-11 | AnneJ}} | |||
</noinclude> | |||
Latest revision as of 10:21, 12 June 2023
This article aims at presenting, as example, the directory structure of the Linux root file system available on STM32 board.
All files and directories are located under the root directory (/), in compliance with the File system Hierarchy Standard.
This root directory corresponds to the Linux root file system (rootfs partition), as defined in Flash partitions. Note also that the user file system (userfs partition), the boot file system (bootfs partition) and the vendor file system (vendorfs partition) can be accessed through the /usr/local mounting point, through the /boot mounting point, and through the /vendor mounting point respectively. Template:InfoTemplate:UpdateNeededForNewRelease
The directories are shown in Template:Green, while the files are in black.
Template:Green Template:Highlight ├── Template:Green Template:Highlight │ └── [...] ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight │ ├── Template:Green │ │ └── Template:Green Template:Highlight │ │ ├── Template:Green Template:Highlight │ │ │ └── [...] │ │ ├── modules.dep Template:Highlight │ │ └── [...] │ └── [...] ├── Template:Green ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ └── [...] ├── Template:Green Template:Highlight └── Template:Green Template:Highlight
- Boot file system mounting point
Template:Green Template:Highlight ├── stm32mp157f-dk2[*].dtb Template:Highlight ├── stm32mp157f-ev1[*].dtb Template:Highlight ├── uImage Template:Highlight └── [...]
- User file system mounting point
Template:Green Template:Highlight ├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ │ ├── Template:Green │ │ │ ├── Template:Green │ │ | | ├── Template:Green Template:Highlight │ │ │ | | ├── fw_cortex_m4.sh Template:Highlight │ │ │ | | ├── Template:Green │ │ │ | | │ └── Template:Green │ │ │ | | │ └── OpenAMP_TTY_echo.elf Template:Highlight │ │ │ | | └── README Template:Highlight │ │ │ │ └── [...] Template:Highlight │ │ │ └── [...] Template:Highlight │ │ ├── Template:Green │ │ │ ├── Template:Green Template:Highlight │ │ │ └── Template:Green │ │ │ └── Template:Green │ │ │ └── AI_Character_Recognition.elf Template:Highlight │ │ └── Template:Green │ │ ├── Template:Green │ │ | └── Template:Green Template:Highlight │ │ | ├── fw_cortex_m4.sh Template:Highlight │ │ | ├── Template:Green │ │ | │ └── Template:Green │ │ | │ └── GPIO_EXTI.elf Template:Highlight │ │ | └── README Template:Highlight │ │ └── [...] Template:Highlight
│ └── Template:Green Template:Highlight │ ├── Template:Green │ │ └── [...] Template:Highlight │ ├── Template:Green │ │ └── [...] Template:Highlight │ └── Template:Green │ └── [...] Template:Highlight
├── Template:Green Template:Highlight │ ├── Template:Green Template:Highlight │ │ ├── Template:Green │ │ │ ├── button_gpio_exti.sh Template:Highlight │ │ | └── README.md Template:Highlight │ │ └── Template:Green Template:Highlight │ │ └── [...] │ └── [...] Template:Highlight ├── Template:Green Template:Highlight │ └── [...] ├── Template:Green └── Template:Green └── start_up_demo_launcher.sh Template:Highlight
- Vendor file system mounting point
Template:Green Template:Highlight ├── [*].so Template:Highlight └── [...]