Page 3 - Copyright notice; All rights reserved.; Contact Information:
Copyright notice Copyright 200 ⓒ 8 Flash Software Group, Samsung Electronics, Co., Ltd.. All rights reserved. Trademarks RFS is trademark of Flash Software Group, Samsung Electronics Co., Ltd.. in Korea and other countries Restrictions on Use and Transfer All software and documents of RFS are commer...
Page 4 - Preface
II Linux RFS v1.3.0 Porting Guide Preface SEC-FSG-RFS1.2-POG This document is a porting guide of RFS developed by Flash Software Group, Memory Division, Samsung Electronics. It describes Linux RFS porting procedure to user's target platform. Purpose This document is RFS Porting Guide. This document ...
Page 5 - History
Related Documents - RFS v1.3.0 Programmer’s Guide, Samsung Electronics, Co., Ltd. - LinuStoreII Utility Guide, Samsung Electronics Co., Ltd. - LinuStoreII Porting Guide, Samsung Electronics Co., Ltd. History Version Date Comment Author 0.1 2006.01.05 Initial Flash Software Group 0.8 2006.01.13 1 st ...
Page 6 - Table of Contents
IV Linux RFS v1.3.0 Porting Guide Table of Contents 1 Introduction ......................................................................................... 1 1.1 Overview ........................................................................................ 1 1.2 Features ...........................
Page 7 - Tables
Tables Table 1 Host System Requirements ......................................................................... 4 Table 2 RFS Static Memory Usage (in bytes) .............................................................. 6 Table 3 Hardware information of OMAP2420 ......................................
Page 8 - Figures
VI Linux RFS v1.3.0 Porting Guide Figures Figure 1-1 Linux RFS Architecture .......................................................................... 2 Figure 2-1 Directory Structure of Linux RFS Package .................................................... 4 Figure 2-2 Linux RFS Source Files (Annot...
Page 9 - Introduction; Overview
1 Introduction This chapter describes the overview and system architecture of RFS. It also covers the information about low-level flash memory partitions. 1.1 Overview Linux RFS (Linux Robust FAT File System) is a FAT compatible file system to use OneNAND/NAND flash memory as storage on any consumer...
Page 10 - Figure 1-1 Linux RFS Architecture
2 Linux RFS v1.3.0 Porting Guide Figure 1-1 Linux RFS Architecture File Systems Linux file system for flash devices is managed by two file systems: CRAMFS and RFS. Both of these file systems run under Linux VFS (Virtual File System). • CRAMFS: This is a read-only file system included in a standard...
Page 12 - Prerequisites; Host Environment; Table 1 Host System Requirements; Software Environment; Directory Structure of Linux RFS Package; Figure 2-1 Directory Structure of Linux RFS Package
4 Linux RFS v1.3.0 Porting Guide 2 Prerequisites This chapter explains the host/target system environment for porting RFS to your target system. Host is Linux PC environment and target can be any kind of consumer device using OneNAND flash memory. 2.1 Host Environment The following table shows the h...
Page 13 - Source Files List; Figure 2-2 Linux RFS Source Files (Annotated on the Source Tree)
fs – RFS file system module drivers - XSR block device driver module tools - Utilities to manipulate RFS scripts- RFS Package Installation scripts Include – includes header files 2.2.2 Source Files List This section gives short description of source files listed in the ‘rfs’ and ‘xsr’ dire...
Page 14 - RFS Memory Usage; Table 2 RFS Static Memory Usage (in bytes); Hardware Environment; Table 3 Hardware information of OMAP2420
6 Linux RFS v1.3.0 Porting Guide Most of the sources are platform-independent codes except PAM. Please refer the “XSR Porting Guide” for more detailed information. Before going into detail about RFS customization according to target requirement, next section will explain about objects that Linux RFS...
Page 15 - Porting Linux RFS; Porting Overview; Figure 3-1 Linux RFS Porting Procedure; Porting Procedure; Installation of Linux RFS Sources
3 Porting Linux RFS This chapter describes porting overview, hardware configuration for OneNAND, Linux RFS initialization and porting procedure with OMAP2420 target board. 3.1 Porting Overview This section describes Linux RFS porting procedure briefly. The procedure is divided into 5 steps as shown ...
Page 16 - Kernel Configuration for RFS; Figure 3-2 Main screen of Kernel menu
8 Linux RFS v1.3.0 Porting Guide If you are using Linux kernel 2.4.xx specify ‘kernel type’ as 24. If you are using Linux kernel 2.6.xx specify ‘kernel type’ as 26. Shell> cd $(TOP_DIR) Shell> $(RFS_TOP_DIR)/scripts/rfs_install.sh 24 3.2.2 Kernel Configuration for RFS 3.2.2.1 Menu Configuratio...
Page 17 - Building Linux Kernel and RFS Kernel Module
Figure 3-3 File system screen of Kernel menu Figure 3-3 shows the detailed RFS configuration. 1. The first is FAT32 and long file name support 2. The second is direct I/O support. But, this feature is experimental and should not be used in production environment. 3. The third is debugging message op...
Page 18 - Figure 3-4 Code maturity level
10 Linux RFS v1.3.0 Porting Guide Figure 3-4 Code maturity level You should set the make option for “COMPRESSED ROM FILE SYSTEM (CRAMFS)” in file system option during make menuconfig because the root file system is managed by CRAMFS.
Page 19 - Figure 3-5 CRMAFS OPTION Settings
Figure 3-5 CRMAFS OPTION Settings Now, you can proceed to build the kernel and the kernel modules. Before starting build process your kernel cross compile path ‘CROSS_COMPILE = ’ must be set in $(KERNEL_TOP_DIR)/Makefile. To build the kernel, type the following commands in sequence. shell> cd $(K...
Page 20 - Kernel Configuration for NLS; Figure 3-6 RFS Filesystem configuration for VFAT
12 Linux RFS v1.3.0 Porting Guide After all of these steps, you will have the kernel image ‘uImage’. For usage of OneNAND device on your target, please refer to ftools utility guide. 3.3 Using the NLS (Native Language Support) The FAT Filesystem can deal with filenames in native language character s...
Page 21 - NOTE
Figure 3-7 NLS(Native Language Support) configuration And you should select the codepages like the default codepage and other codepages to be used at the target. Then, the codepages will be compiled as built-in or module. For example, if you set the default codepage to “cp949” for Korean, you have t...
Page 22 - Figure 3-8 RFS Filesystem configuration for FAT16; Mounting RFS with codepage
14 Linux RFS v1.3.0 Porting Guide Figure 3-8 RFS Filesystem configuration for FAT16 If you decide to build RFS Filesystem as FAT16 type, you always make the filenames with the native language in the 8.3 format regardless of NLS support. Why is this possible? The NLS is used for the conversion the fi...
Page 24 - Appendix
16 Linux RFS v1.3.0 Porting Guide Appendix I. Description of FAT Configuration Option z CONFIG_RFS_FS Description Configuration option for RFS Behavioral description This option should be set for RFS support. Additional notice None z CONFIG_RFS_VFAT Description To avoid the patent problems related t...
