search

agherzan / meta-chip

Yocto BSP layer for C.H.I.P. boards
MIT License
15 stars 21 forks source link

readme

This README file contains information on building the meta-chip BSP layer. Please see the corresponding sections below for details.

Dependencies

This layer depends on:

URI: git://git.openembedded.org/bitbake branch: master

URI: git://git.openembedded.org/openembedded-core layers: meta branch: master

URI: git://github.com/linux-sunxi/meta-sunxi.git branch: master

Contributing

Mailing list The main communication tool we use is a mailing list:

Patches and pull requests All the contributions should be compliant with the openembedded patch guidelines: http://www.openembedded.org/wiki/Commit_Patch_Message_Guidelines To contribute to this project you should send pull requests to the github repository (https://github.com/agherzan/meta-chip). Additionally you can send the patches for review to the above specified mailing list so that more people can see and review your contributions.. When creating patches for the mailing list, please use something like:

git format-patch -s --subject-prefix='meta-chip][PATCH' origin

When sending patches to the mailing list, please use something like:

git send-email --to yocto@yoctoproject.org <generated patch>

Github issues In order to manage and trace the meta-chip issues, we use github issues: https://github.com/agherzan/meta-chip/issues

Table of Contents

I. Building the meta-chip BSP layer II. Flashing a C.H.I.P. board

I. Building the meta-chip BSP layer

To build a machine supported by this BSP layer follow the next steps:

  1. source poky/oe-init-build-env chip-build
  2. Add needed layer to bblayers.conf:
    • meta-chip 3 Set MACHINE to "chip" in local.conf
  3. bitbake chip-hwup-image

II. Flashing a C.H.I.P. board

As part of the build including this BSP layer, a U-Boot script and a shell script are created to assist in flashing your images to the CHIP board. Note that this script assumes a maximum size for your UBI image of 167772160 (0x0A000000) bytes. If your UBI image exceeds that, then you will need to adapt this to your environment.

To successfully run this script you will first need to set your board into FEL mode. Insert a wire into the U14 header between pin 7 (FEL) and GND. Then connect the board with a USB cable to your host. More details here: https://docs.getchip.com/chip.html#flash-chip-with-an-os

You need to specify the base filename of your UBI image using the UBI_IMAGE shell variable before invoking the generated script as follows:

UBI_IMAGE=chip-hwup-image-chip.ubi \

    ./tmp/deploy/images/chip/flash_CHIP_board.sh

This script will take some time to execute. The output of this script as run on your host machine should look similar to the following:

# UBI_IMAGE=chip-hwup-image-chip.ubi ./tmp/deploy/images/chip/flash_CHIP_board.sh
100% [================================================]  3537 kB,  513.9 kB/s
100% [================================================]   619 kB,  551.1 kB/s
100% [================================================]     2 kB,  476.0 kB/s
100% [================================================] 71303 kB,  531.1 kB/s

If you have a serial console connected to your board, you will see progress and a message on the console indicating when flashing is complete:

U-Boot 2016.01 (Jun 20 2017 - 02:54:42 -0400) Allwinner Technology

CPU:   Allwinner A13 (SUN5I)
I2C:   ready
DRAM:  512 MiB
NAND:  8192 MiB
video-mode 720x480-24@60 not available, falling back to 1024x768-24@60
Setting up a 720x480i composite-ntsc console (overscan 40x20)
In:    serial
Out:   serial
Err:   serial
Net:   usb_ether
starting USB...
No controllers found
Hit any key to stop autoboot:  0
(FEL boot)
## Executing script at 43100000
Erasing NAND

NAND erase.chip: device 0 whole chip
Skipping bad block at  0xeb000000
Skipping bad block at  0x1b1000000
Erasing at 0x1ffc00000 -- 100% complete.
OK
Writing SPL (with ECC) to NAND address 0x00000000

NAND write:  3537408 bytes written: OK
Writing SPL (with ECC) to NAND address 0x400000

NAND write:  3537408 bytes written: OK
Writing UBoot image to address 0x800000

NAND write: device 0 offset 0x800000, size 0x97236
 619062 bytes written: OK
Enabling Splash
Setting Video Mode
Saving default environment
Saving Environment to NAND...
Erasing NAND...
Erasing at 0xc00000 -- 100% complete.
Writing to NAND... OK
Writing UBI rootfs to NAND address 0x1000000

NAND write: device 0 offset 0x1000000, size 0xa000000
 167772160 bytes written: OK
===========================================================
Flashing Complete. Please power down and disable FEL mode.
===========================================================

Additionally, once the image is properly flashed, the status LED on the CHIP board will flash on and off every 2 seconds. This indicates that it is safe to power down your board and disable FEL mode.

WARNING: This will erase the entire contents of your CHIP board.

NOTE: This setup is still compatible with the CHIP flashing utility available at http://flash.getchip.com if you choose to reinstall the stock images.