Organize top RPB folder
Move many files around into Extras folder to organize top folder. Should optimize workflow. Signed-off-by: Robert Wolff <robert.wolff@linaro.org>
This commit is contained in:
Robert Wolff
parent
a380422c68
commit
21899c0462
66 changed files with 9 additions and 0 deletions
|
|
@ -0,0 +1,122 @@
|
|||
### How to get and customize the kernel source code
|
||||
|
||||
#### Building the Linux kernel from source
|
||||
|
||||
The Linux kernel used in this release is available via tags in the git [repository](https://github.com/rsalveti/linux)
|
||||
|
||||
```
|
||||
git: https://github.com/rsalveti/linux
|
||||
tag: 96boards-rpb-debian-15.10-qcom
|
||||
defconfig: arch/arm64/defconfig kernel/configs/distro.config
|
||||
```
|
||||
|
||||
The kernel image (`Image`) is located in the `boot` image and partition and the kernel modules are installed in the root file system. It is possible for a user to rebuild the kernel and run a custom kernel image instead of the released kernel. You can build the kernel using any recent GCC release using the git tree, tag and defconfig mentioned above. This release only supports booting with device tree, as such both the device tree blobs need to be built as well.
|
||||
|
||||
The DragonBoard 410c is an ARMv8 platform, and the kernel is compiled for the Aarch64 target. Even though it is possible to build natively, on the target board, It is recommended to build the Linux kernel on a PC development host. In which case you need to install a cross compiler for the ARM architecture. It is recommended to download the [Linaro GCC cross compiler (Aarch64 little-endian)](http://releases.linaro.org/14.11/components/toolchain/binaries/aarch64-linux-gnu/gcc-linaro-4.9-2014.11-x86_64_aarch64-linux-gnu.tar.xz).
|
||||
|
||||
To build the Linux kernel, you can use the following instructions:
|
||||
|
||||
```
|
||||
git clone -n https://github.com/rsalveti/linux.git
|
||||
cd linux
|
||||
git checkout -b kernel-rpb-15.10 96boards-rpb-debian-15.10-qcom
|
||||
export ARCH=arm64
|
||||
export CROSS_COMPILE=<path to your GCC cross compiler>/aarch64-linux-gnu-
|
||||
make defconfig distro.config
|
||||
make -j4 Image dtbs KERNELRELEASE=4.3.0-your-custom-release
|
||||
```
|
||||
|
||||
#### Building a boot image
|
||||
|
||||
You now need to create a valid boot image with your own kernel build.
|
||||
|
||||
On your host PC, we need to install the following tools:
|
||||
|
||||
```
|
||||
sudo apt-get install device-tree-compiler
|
||||
git clone git://codeaurora.org/quic/kernel/skales
|
||||
```
|
||||
|
||||
The boot image consists of the table of device tree (`dt.img`), the kernel image (`Image`) and an init ramdisk image.
|
||||
|
||||
The `dtbTool` is a standalone application that will process the DTBs generated during the kernel build, to create the table of device tree image. This tool is included in the @skales@ git tree cloned above.
|
||||
|
||||
`./skales/dtbTool -o dt.img -s 2048 arch/arm64/boot/dts/qcom/`
|
||||
|
||||
To create the boot image, you also need a ramdisk image, and you can use the one available at _/boot_ from the rootfs.
|
||||
|
||||
The tool `mkbootimg` (also in the git tree previously cloned) is a standalone application that will process all files and create the boot image that can then be booted on the target board, or flash into the on-board eMMC. The boot image also contains the kernel bootargs, which can be changed as needed in the next command:
|
||||
|
||||
```
|
||||
./skales/mkbootimg --kernel arch/arm64/boot/Image \
|
||||
--ramdisk initrd.img \
|
||||
--output boot-db410c.img \
|
||||
--dt dt.img \
|
||||
--pagesize 2048 \
|
||||
--base 0x80000000 \
|
||||
--cmdline "root=/dev/disk/by-partlabel/rootfs rw rootwait console=ttyMSM0,115200n8"
|
||||
```
|
||||
|
||||
#### Booting a custom boot image
|
||||
|
||||
Assuming you have now built a valid boot image called `boot-db410c.img`, you can run the following `fastboot` command to boot it on the board:
|
||||
|
||||
`sudo fastboot boot boot-db410c.img`
|
||||
|
||||
If you want to permanently use a custom kernel image, you can update the boot image and reflash it into the `boot` partition:
|
||||
|
||||
`sudo fastboot flash boot boot-db410c.img`
|
||||
|
||||
#### How to get and customize the bootloader
|
||||
|
||||
While the first stage bootloader is proprietary and released as firmware blob available on [Qualcomm Developer Network](https://developer.qualcomm.com/download/linux-ubuntu-board-support-package-v1.zip), the second stage bootloader is `LK` and is open source.
|
||||
|
||||
The original LK source code is available on "CodeAurora.org":https://www.codeaurora.org/cgit/quic/la/kernel/lk/, and the source code which is used in this release can be found in the [Linaro Qualcomm Landing Team git repository](https://git.linaro.org/landing-teams/working/qualcomm/lk.git):
|
||||
|
||||
```
|
||||
git: http://git.linaro.org/landing-teams/working/qualcomm/lk.git
|
||||
tag: ubuntu-qcom-dragonboard410c-LA.BR.1.2.4-00310-8x16.0-linaro1
|
||||
```
|
||||
|
||||
To build the LK bootloader, you can use the following instructions:
|
||||
|
||||
```
|
||||
git clone git://codeaurora.org/platform/prebuilts/gcc/linux-x86/arm/arm-eabi-4.8.git -b LA.BR.1.1.3.c4-01000-8x16.0
|
||||
git clone http://git.linaro.org/landing-teams/working/qualcomm/lk.git -b ubuntu-qcom-dragonboard410c-LA.BR.1.2.4-00310-8x16.0-linaro1
|
||||
cd lk
|
||||
make -j4 msm8916 EMMC_BOOT=1 TOOLCHAIN_PREFIX=<path to arm-eabi-4.8 tree>/bin/arm-eabi-
|
||||
```
|
||||
|
||||
The second stage bootloader is flashed on the `aboot` partition, you can now flash your board with:
|
||||
|
||||
`sudo fastboot aboot ./build-msm8916/emmc_appsboot.mbn`
|
||||
|
||||
#### How to get and customize Debian packages source code
|
||||
|
||||
This release is based on Debian 8.2 "Jessie".
|
||||
|
||||
Since all packages installed in Linaro Debian-based images are maintained either in Debian archives or in Linaro repositories, it is possible for users to update their environment with commands such as:
|
||||
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade
|
||||
```
|
||||
|
||||
All user space software is packaged using Debian packaging process. As such you can find extensive information about using, patching and building packages in The Debian New Maintainers Guide. If you quickly want to rebuild any package, you can run the following commands to fetch the package source code and install all build dependencies:
|
||||
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get build-dep <pkg>
|
||||
apt-get source <pkg>
|
||||
```
|
||||
|
||||
Then you can rebuild the package locally with:
|
||||
|
||||
```
|
||||
cd <pkg-version>
|
||||
dpkg-buildpackage -b -us -uc
|
||||
```
|
||||
|
||||
#### TODO
|
||||
|
||||
- Explain how to build the rootfs from source
|
||||
|
|
@ -0,0 +1,81 @@
|
|||
## Install Instructions - CE Debian RPB 15.10 - Dragonboard410c
|
||||
|
||||
This guide describes how to get started with the CE Debian Reference Platform Build, release 15.10, for Dragonboard410c.
|
||||
|
||||
For more information about the Dragonboard410c development board, please check https://www.96boards.org/products/ce/dragonboard410c/
|
||||
|
||||
### Image Components
|
||||
|
||||
The CE Debian RPB 15.10 - Dragonboard410c build is composed of the following artifacts:
|
||||
|
||||
- Bootloader:
|
||||
- [Qualcomm proprietary first stage bootloader](https://developer.qualcomm.com/download/linux-ubuntu-board-support-package-v1.zip)
|
||||
- [Little Kernel](https://git.linaro.org/landing-teams/working/qualcomm/lk.git) as second stage boot loader
|
||||
- Linux Kernel:
|
||||
- Upstream plus extra changes for a better hardware support
|
||||
- Git: https://github.com/rsalveti/linux.git
|
||||
- Branch: *reference-qcom-rebase*
|
||||
- Debian "Jessie"
|
||||
- ALIP (LXDE based)
|
||||
- Custom 96Boards artworks and default settings
|
||||
- Additional packages provided by [linaro-overlay](http://repo.linaro.org/ubuntu/linaro-overlay)
|
||||
|
||||
#### Closed source binaries
|
||||
|
||||
This release contains proprietary firmware. You can also download the proprietary firmware separately, from [here](https://developer.qualcomm.com/download/db410c/firmware-410c-1.1.0.bin). All the required firmware files are pre-installed, and the image is bound to the following [license agreement](https://git.linaro.org/landing-teams/working/qualcomm/lt-docs.git/blob_plain/HEAD:/license/license.txt).
|
||||
|
||||
### Downloading the pre-built binaries
|
||||
|
||||
The build is mainly composed by two image files (boot and rootfs), but to avoid incompatibilities issues with older bootloaders, or different partition tables, it's also recommended to flash the bootloader.
|
||||
|
||||
Flashing and booting from the external SD Card is not supported by this release.
|
||||
|
||||
*Bootloader files:*
|
||||
|
||||
Download the latest bootloader zip from [http://builds.96boards.org/releases/dragonboard410c/linaro/rescue/latest](http://builds.96boards.org/releases/dragonboard410c/linaro/rescue/latest/dragonboard410c_bootloader_emmc_linux*.zip)
|
||||
|
||||
*CE Debian RPB image:*
|
||||
|
||||
```
|
||||
wget https://builds.96boards.org/releases/reference-platform/debian/dragonboard410c/15.10/dragonboard410c-boot-linux-20151106-31.img.gz
|
||||
wget https://builds.96boards.org/releases/reference-platform/debian/dragonboard410c/15.10/dragonboard410c-rootfs-debian-jessie-alip-20151106-31.emmc.img.gz
|
||||
gunzip dragonboard410c-*
|
||||
```
|
||||
|
||||
### Flashing
|
||||
|
||||
#### Bootloader
|
||||
|
||||
Flash the eMMC with the bootloader:
|
||||
|
||||
- Unzip the bootloader that was downloaded in the previous step. Note the directory that is it located in.
|
||||
- Assure that a micro USB cable is connected from the micro-USB port on the DB410c to the host PC
|
||||
- Assure micro SD Card slot is empty on the DB410c
|
||||
- Set the S6 switch on the DB410c to: 0-0-0-0 {SD Boot set to off}
|
||||
- Power on the DB410c into fastboot mode
|
||||
- Press and hold the Vol (-) button on the DB410c (S4)
|
||||
- While pressing S4 button, power up the DB410c. It will come up in fastboot mode
|
||||
- From the host PC terminal window, run the following commands:
|
||||
|
||||
```
|
||||
# Check to make sure fastboot device connected. If not resolve
|
||||
sudo fastboot devices
|
||||
# cd to the directory the bootloader zip file was extracted
|
||||
cd <extraction directory>
|
||||
sudo ./flashall
|
||||
```
|
||||
|
||||
The bootloader is now installed on the DB410c.
|
||||
|
||||
#### Boot and Rootfs
|
||||
|
||||
Fastboot is required to flash both the boot and rootfs images.
|
||||
|
||||
*Flashing boot and rootfs:*
|
||||
|
||||
```
|
||||
sudo fastboot flash boot dragonboard410c-boot-linux-20151106-31.img
|
||||
sudo fastboot flash rootfs dragonboard410c-rootfs-debian-jessie-alip-20151106-31.emmc.img
|
||||
```
|
||||
|
||||
Once flashed just reboot the board and enjoy :-)
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
## Dragonboard™ 410c - Reference Platform Build - 15.10
|
||||
|
||||
- **Install Instructions:** For "out-of-box" users. Instructions for installing pre-build Reference Platform images onto your 96Boards.
|
||||
- **Build from Source:** For Advanced users. Instructions for building and installing the various Reference Platform components used by Consumer Edition 96Boards.
|
||||
- **Known Issues:** List of current bugs and issues for each Reference Platform Build. Includes links to bug reports for tracking resolution progress.
|
||||
- **Test Report:** Provides test results and bug status for kernel, firmware, and images with a straight forward pass/fail legend.
|
||||
|
||||
***
|
||||
|
||||
| **CE Debian RPB - 15.10** |
|
||||
|:-----------------------------:|
|
||||
| [Install Instructions](InstallDebianRPB-15.10.md) |
|
||||
| [Build from Source](BFSDebianRPB-15.10.md) |
|
||||
| [Known issues](../../Known-Issues.md) |
|
||||
| [Test Report](https://builds.96boards.org/releases/reference-platform/debian/dragonboard410c/16.03/CE-Debian-RPB-16.03-Dragonboard410c-TestReport.pdf) |
|
||||
Loading…
Add table
Add a link
Reference in a new issue