diff options
| author |   Pierre Marzin <pierre.marzin@iot.bzh> | 2019-07-30 17:24:05 +0200 |
|---|---|---|
| committer |   Jan-Simon Moeller <jsmoeller@linuxfoundation.org> | 2019-08-06 23:11:21 +0000 |
| commit | c76deb0dbe20c5e9274788823693c311d9f06110 (patch) | |
| tree | 66b767f86e86dfa1807f03e72974188ec86c417e /templates/machine | |
| parent | 450345f3406c55d2fe8284aa0122115fed00d182 (diff) | |
machine: Add readme for ebisu
Bug-AGL: SPEC-1902
Change-Id: I73fcf4da0e96497ee98a043bdc8d7cc1da1b11a6
Signed-off-by: Pierre Marzin <pierre.marzin@iot.bzh>
Diffstat (limited to 'templates/machine')
| -rw-r--r-- | templates/machine/ebisu/README_machine_ebisu.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/templates/machine/ebisu/README_machine_ebisu.md b/templates/machine/ebisu/README_machine_ebisu.md new file mode 100644 index 000000000..eb5666ecc --- /dev/null +++ b/templates/machine/ebisu/README_machine_ebisu.md @@ -0,0 +1,44 @@ +--- +description: machine ebisu +author: <undefined> +--- +## Machine 'ebisu' + +### Prepare the build + +Before building the AGL distribution for Renesas 'ebisu' board, it is necessary to prepare the environnement. See [AGL Doc - Initializing Your Build Environment](https://docs.automotivelinux.org/docs/en/master/getting_started/reference/getting-started/image-workflow-initialize-build-environment.html) before going to the next step. + +The 'ebisu' board need some specifics binaries in order to build. These binaries contain Graphics support, specific drivers... They are only delivered by Renesas. +Before setting up the build with `meta-agl/scripts/aglsetup.sh`, the environment variable `EBISU_BIN_PATH` need to be set. This variable specify the path to a folder which contains all ebisu's binaries zip files. + +Moreover, it's possible to launch a custom bash script during the setup. This optional step will be called at the end of the `aglsetup.sh` sequence. This can be used to add a specific configuration to the official setup or add a hotfix. + +Example: +```bash +$ cd $AGL_TOP +$ export EBISU_BIN_PATH=/home/user/Downloads/ebisu_binaries +$ export CUSTOM_RENESAS_CONFIG_SCRIPT=/path/to/my/Renesas_custom_setup_ebisu.sh #optional +$ source meta-agl/scripts/aglsetup.sh -m ebisu agl-demo -f +``` + +### Launch the build + +When your environnment is ready, you can launch the AGL build with `bitbake` : + +```bash +$ cd $AGL_TOP +$ bitbake agl-demo-platform +``` + +### Debugging the board + +To debug the ebisu board, the PC should be connected to the CN25 USB serial port. +And the serial communication's protocol of the terminal software on the PC should be set as follows: + +Parameter | Value +--- | --- +Transfer rate | 115200 bps +Data length | 8 bits +Parity | Not in use +Stop bit | 1 bit +Flow control | Not provided |