mxuport/0040777000000000000000000000000014152020140007517 5ustar00mxuport/arm_porting_guide.txt0100777000000000000000000014754414152017431014006 0ustar00============================================================================= MOXA UPort Series Driver version 4.x Arm-based platform Porting Guide Date: 08-09-2021 Copyright (C) 2021, MOXA Inc. ============================================================================= Content 1. Introduction 2. Port to Moxa UC-Series - Arm Based Computer 2.1 Build binaries on a general ARM platform 2.2 Cross-compiler and the UPort series driver 2.3 Moxa cross-compiling interactive script 2.4 Manually build the UPort series driver with a cross-compiler 2.5 Deploy cross-compiled binary to target 3. Porting to Raspberry Pi OS 4. Porting to the Yocto Project on Raspberry Pi 4.1 Prerequisite 4.2 Create a Moxa layer for the Yocto Project 4.3 Install a Moxa Layer into the Yocto Project 4.4 Deploy the Yocto image in Raspberry Pi 4.5 Start the UPort driver in Raspberry Pi 4.6 Troubleshooting ----------------------------------------------------------------------------- 1. Introduction This document is about porting Moxa UPort series driver to the specified Arm-based platform. The following knowledge is recommended before reading the instructions in this guide. - Linux Kernel Programming - ARM Platform Compiler - Yocto Project Document - MOXA UC-Series Manual - Raspberry Pi Manual Instructions in this guide use examples of porting on the Moxa UC-Series Arm platform and Raspberry Pi. You can apply the experience of porting UPort series driver to other platforms. The UPort series driver fully supports all modern-day Linux distributions running on x86 environments, and the driver core is also compatible with the Arm platform. This document will guide you on how to port the UPort series driver core. However, some platform-dependent services, such as installer, are not available. You may refer to the platform’s documentation to fulfill the requirements. ----------------------------------------------------------------------------- 2. Porting to Moxa UC-Series - Arm-Based Computer 2.1 Build binaries on a general ARM platform If your platform is powerful and consists of the necessary development tools, the driver can be built on the platform directly. You can refer to readme.txt of UPort series driver to understand the requirement. The step of building this driver in an ARM environment is the same as in x86 and x64 environment. UPort 1100 Series driver # tar zxvf [DRIVER NAME].tgz # cd mxu11x0 # ./mxinstall UPort 1200/1400/1600 Series driver # tar zxvf [DRIVER NAME].tgz # cd mxuport # ./mxinstall UPort 2210/2410 Series driver # tar zxvf [DRIVER NAME].tgz # cd mxuport2000 # ./mxinstall 2.2 Cross-compiler and the UPort series driver +--------------------------------------------------------------------+ | Note: To cross-compile on a x86 or x64 Linux host, the target ARM | | environment's kernel source package and cross compiler | | toolchain must be installed first. | +--------------------------------------------------------------------+ After installing and configuring the kernel source package and toolchain, you need to compile all of the source code with the kernel source package and toolchain. In this example, we install the cross-compiler for the Moxa UC-Series ARM-based computer. You can refer to the product's manual for further detail. (1) Download the cross-compiler toolchain and the kernel source package webpage under the product page. $ git clone https://github.com/Moxa-Linux/am335x-linux-4.4 You can use the following command to show the git tag list and checkout to the tag of specific UC device and firmware version. Show the tag list. $ git tag Checkout to the specific tag. $ git checkout UC-2100_V1.7 <--- Replace the tag name, UC-2100_V1.7, with the UC Series that is being used. (2) Download the toolchain from the product's webpage. The toolchain, which is used by the UC Series, is arm-linux-gnueabihf. It is a script that will install the related packages. Execute the script and follow the steps to install the Linux cross-compiler tools. You will need the root privilege to install the toolchain and the kernel source. # sh arm-linux-gnueabihf_6.3_Build_amd64_.sh If the script shows the notification message: "Please export these environment variables before using toolchain", enter the following script command: # export PATH=$PATH:/usr/local/arm-linux-gnueabihf-6.3/usr/bin (3) The kernel source, which is used by the UC Series, is am335x-linux-4.4. You need to configure these files before starting to cross-compile. Move the kernel source to /moxa/kernel and configure the kernel source. # mv am335x-linux-4.4 /moxa/kernel # cd /moxa/kernel # make uc2100_defconfig <--- Replace the uc2100 with the UC Series that is being used. # make modules_prepare After the abov