RZ/G Verified Linux Package V2.1.0-RT

Transcription

1 RZ/G Verified Linux Package V2.1.0-RT R01TU0254EJ0100 Rev Introduction This release note describes the contents, building procedures and important points of the RZ/G Verified Linux Package V2.1.0-RT (hereinafter referred to as VLP ). And this document also describes the environment to build VLP without using RZ/G Development Platform. If you need information about the platform, please refer to RZ/G Linux Platform Tools User s Manual for the RZ/G Series. Contents 1. Release Items Build environment Building Instructions Changes from previous version Restrictions Note R01TU0254EJ0100 Rev Page 1 of 11

2 1. Release Items Name and version RZ/G Verified Linux Package V2.1.0-RT Distribution method Provided via the RZ/G Marketplace. Please visit the sites below and make your account to download the package. RZ/G Marketplace: America: Europe: Asia: Japan: Target boards RZ/G1H-PF Qseven Development Platform RZ/G1M-PF Qseven Development Platform RZ/G1N-PF Qseven Development Platform RZ/G1E-PF SODIMM Development Platform RZ/G1C-PF Pi SBC Development Platform These boards are provided by iwave Systems Technologies Pvt. Ltd. Verified functions Linux BSP - Linux Kernel - Linux Drivers - Graphics Libraries GUI Framework - Qt (LGPL version) - Gecko File contents VLP is delivered by the files listed in Table 1. If you want to download full set of VLP, download the files listed as Basic packages. If you already have full set of VLP2.1.0 and you want to download minimal set of files, download the files listed as Optional files for updating from VLP R01TU0254EJ0100 Rev Page 2 of 11

3 Table 1. RZ/G Verified Linux Package Basic packages File rzg_bsp_eva_v210rt.tar.gz (Evaluation version, 99MB) rzg_bsp_pro_v210rt.tar.gz (Product version, 99MB) oss_pkg.7z.001 (500MB) oss_pkg.7z.007 (500MB) oss_pkg.7z.002 (500MB) oss_pkg.7z.008 (500MB) oss_pkg.7z.003 (500MB) oss_pkg.7z.009 (500MB) oss_pkg.7z.004 (500MB) oss_pkg.7z.010 (500MB) oss_pkg.7z.005 (500MB) oss_pkg.7z.011 (500MB) oss_pkg.7z.006 (500MB) oss_pkg.7z.012 (411MB) r01tu0254ej0100-rz-g.pdf r01us0384ej0100-rz-g.pdf Explanation Yocto recipe packages (including Multimedia package) Open Source packages (Divided files) This document Component list Optional files for using HTML5 rendering engine File r01us0385ej0100-rz-g.pdf Explanation Build instructions for HTML5 Optional files for updating from VLP File Explanation r01tu0256ej0100-rz-g.pdf Patch application guide for VLP non-rt version users rzg_bsp_eva_diff_v210rt.tar.gz (Evaluation version) Diff files of Yocto recipes compared with rzg_bsp_pro_diff_v210rt.tar.gz (Product version) VLP non-rt version v210-to-v210rt.oss_packages.7z Diff files of OSS packages compared with VLP non-rt version Note) In the next release of VLP RT version, diff files are going to be provided compared with VLP RT. Please note that VLP2.1.0-RT is the last release with which diff files compared with VLP non-rt version is provided. R01TU0254EJ0100 Rev Page 3 of 11

4 2. Build environment Figure 1 shows the overall constitution of the recommended environment of VLP. This environment uses the equipment and the software listed in Table 2. Please refer to RZ/G Verified Linux Package Start-Up Guide for details about setting up the environment. Hub Straight Ethernet cable (Straight Ethernet cable) [Linux Host PC] TFTP server NFS server RZ/G1H, RZ/G1M, RZ/G1N Qseven Development Platform RZ/G1E SODIMM Development Platform RZ/G1C Pi SBC Development Platform Target Board USB cable *type A to mini/micro AB Note) Functions in covered with () are optional [Windows7 or 10 Host PC] Terminal software to display console (ssh to control Linux Host) Figure 1. Recommended Environment Table 2. Equipment and Software Necessary for Developing Environments of RZ/G Linux Platform Equipment Linux Host PC OS TFTP server NFS server Windows Host PC OS Terminal software VCP Driver Description Used as build/debug environment Max 100GB free space on HDD is necessary Ubuntu LTS is recommended 64 bit OS must be used. Used for downloading the Linux kernel to the board Used for mounting rootfs via NFS Used as debug environment, controlling with terminal software Windows 7 or 10 are recommended Used for controling serial console of the target board Tera Term (latest version) is recommended Available at Virtual COM Port driver which enables to communicate Windows Host PC and the target board via USB which is virtually used as serial port. Available at R01TU0254EJ0100 Rev Page 4 of 11

5 3. Building Instructions VLP supports two GUI frameworks: Qt and HTML5 (Gecko). But these cannot be used at the same time. The method below enables Qt. If you want to use HTML5, please enable the framework according to the steps at Building Instructions for HTML5. Before starting this instruction, run the command below on Linux host PC to install packages used for building VLP. $ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \ build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \ xz-utils debianutils iputils-ping libsdl1.2-dev xterm p7zip-full Please refer to the URL below for detailed information: (1) Make working directory (user_work), and decompress Yocto recipe package $ mkdir./user_work $ tar xvzf./rzg_bsp_type_v210rt.tar.gz -C./user_work Please apply pro or eva to type. Copy compressed Yocto recipe package files (rzg_bsp_pro_v210.tar.gz for product version, rzg_bsp_eva_v210.tar.gz for evaluation version) to current directory prior to this step. (2) Set a shell variable $ export WORK=/home/user/user_work (3) Execute the copy script for proprietary software $ cd $WORK/meta-renesas/meta-rzg1 $./copy_mm_software_lcb.sh../../mmp $./copy_gfx_software_rzg1x.sh../../mmp (*1) (*1) Run the script correspond to the target board copy_gfx_software_rzg1h.sh RZ/G1H copy_gfx_software_rzg1e.sh RZ/G1E copy_gfx_software_rzg1m.sh RZ/G1M copy_gfx_software_rzg1c.sh RZ/G1C copy_gfx_software_rzg1n.sh RZ/G1N (4) Setup build environment $ cd $WORK $ source poky/oe-init-build-env (5) Prepare default configuration files for the target board $ cd $WORK/build/conf $ cp../../meta-renesas/meta-rzg1/templates/<board>/*.conf./ Fill the directory name correspond to the target board to <board> iwg21m: iwave board for RZ/G1H iwg22m: iwave board for RZ/G1E iwg20m-g1m: iwave board for RZ/G1M iwg23s: iwave board for RZ/G1C iwg20m-g1n: iwave board for RZ/G1N Make sure to add second argument./ as a destination for cp command. R01TU0254EJ0100 Rev Page 5 of 11

6 Note) If you do not want to use Qt framework, please disable Qt by changing the line in the local.conf as below: enable ENABLE_QT_FRAMEWORK = "1" disable ENABLE_QT_FRAMEWORK = "0" If you want to run Qt HMI demo applications, please copy the file as below instead of the command above. $ cp../../meta-rzg-demos/meta-rzg1/qt-hmi-demo/template/<board>/*.conf./ (6) Decompress OSS files to build directory $ cd $WORK/build $ 7z x./oss_pkg.7z.001 (*2) Copy compressed Yocto recipe package files (oss_pkg.7z oss_pkg.7z.012) to build directory prior to this step. All OSS packages will be decompressed at the step marked *2. 7ziped files are not able to decompress individually. All oss_pkg.7z files must be placed at a same directory before running 7z command. (7) Start the build $ cd $WORK/build $ bitbake core-image-weston Building an image can take up to a few hours depending on your host system performance. After the build has been completed successfully, you will see the output similar to: NOTE: Tasks Summary: Attempted 4945 tasks of which 16 didn't need to be rerun and al l succeeded. and the command prompt will return. Note) If the error message below is shown and fail to build, please set your name and address according to the message and try again to build. *** Please tell me who you are. Run git config --global user. "you@example.com" git config --global user.name "Your Name" to set your account's default identity. Omit --global to set the identity only in this repository. fatal: unable to auto-detect address (got 'renesas@rzg.(none)') All necessary files listed in Table 3 will be generated by bitbake command at build/tmp/deploy/images directory. R01TU0254EJ0100 Rev Page 6 of 11

7 Table 3 RZ/G1H RZ/G1M RZ/G1N RZ/G1E RZ/G1C Image files Linux kernel Device tree file root filesystem Kernel modules u-boot uimageiwg21m.bin uimage-r8a7742- core-image-weston- modules-iwg21m.tgz u-bootiwg21m.bin iwg21m.dtb iwg21m.tar.bz2 u-boot-iwg20mg1m.bin uimageiwg20m-g1n.bin uimage-r8a7744- iwg20m.dtb u-boot-iwg20mg1m.bin uimageiwg22m.bin uimage-r8a7745- iwg22m.dtb u-bootiwg22m.bin uimageiwg23s.bin uimage-r8a iwg23s.dtb modules-iwg22m.tgz modules-iwg23s.tgz uimageiwg20m-g1m.bin uimage-r8a7743- iwg20d-q7-dbcmca.dtb core-image-westoniwg20m-g1m.tar.bz2 modules-iwg20mg1m.tgz core-image-westoniwg20m-g1n.tar.bz2 modules-iwg20mg1n.tgz core-image-westoniwg22m.tar.bz2 core-image-westoniwg23s.tar.bz2 u-bootiwg23s.bin R01TU0254EJ0100 Rev Page 7 of 11

8 4. Changes from previous version This version adds the support of the PREEMPT_RT kernel configuration. Version information of all components are available at Component list of VLP RT. Almost all components are same as VLP normal version. Table 4. Versions of commonly used components Components VLP VLP RT Linux kernel cip cip25-rt GCC (Linaro GCC ) (Linaro GCC ) glibc 2.19 (CIP) 2.19 (CIP) binutils (CIP) (CIP) busybox (CIP) (CIP) openssl 1.0.1t (CIP) 1.0.1t (CIP) gstreamer wayland weston python python Qt (LGPL version) Gecko Note) CIP version of components is going to be maintained by CIP project for over ten years. We recommend you use Ubuntu 16.04, and do not use which was used for previous version of VLP. Support for Ubuntu LTS is going to be expired in Apr Booting method and required settings are not changed from previous version. Please refer to RZ/G Verified Linux Package Start-Up Guide. R01TU0254EJ0100 Rev Page 8 of 11

9 5. Restrictions (1) SDK When installing SDK to the directory which name have longer than 16 characters, error messages are shown. Workaround: Please install SDK to the default directory (/opt/poky/2.4.2). Affect: All processors. R01TU0254EJ0100 Rev Page 9 of 11

10 6. Note (1) GStreamer OSS module gstreamer1.0-plugins-bad and gstreamer1.0-omx cannot build offline using the default settings of them. If you want to build whole BSP without connecting network, please follow the steps below. 1. Prepare build environment according to the section 3 (1) to (6) 2. Unpack the module $ cd $WORK/build $ bitbake -c unpack gstreamer1.0-plugins-bad $ bitbake -c unpack gstreamer1.0-omx 3. Move to the directory which contains the file to be modified $ cd tmp/work/<arch>-poky-linux-gnueabi/gstreamer1.0-plugins-bad/ r0/git Note) <arch> will be cortexa15hf-neon or cortexa7hf-neon 4. Modify the address for acquiring a submodule $ vi.gitmodules Before: [submodule "common"] After: path = common url = [submodule "common"] path = common url = file:///home/user/work/build/oss_packages/git.anongit.freedesktop.org. git.gstreamer/common/ Note) Please set your working directory using absolute path. All necessary files are included in the OSS package file of VLP. 5. Apply the change $ git submodule init $ git submodule update 6. Move to the other directory which contains the file to be modified $ cd $WORK/build/tmp/work/<arch>-poky-linux-gnueabi/gstreamer1.0-omx/ r0/git 7. Modify the address and apply the change as same as step 4 and Build BSP according to the section 3 (7) R01TU0254EJ0100 Rev Page 10 of 11

11 Website and Support Renesas Electronics Website Inquiries All trademarks and registered trademarks are the property of their respective owners. R01TU0254EJ0100 Rev Page 11 of 11