summaryrefslogtreecommitdiffstats
path: root/templates
diff options
context:
space:
mode:
Diffstat (limited to 'templates')
-rw-r--r--templates/machine/ebisu/README_machine_ebisu.md44
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
Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */
{
	"flutter-version": "3.3.1",
	"platforms": [
		{
			"id": "desktop-auto",
			"type": "host",
			"arch": "x86_64",
			"flutter_runtime": "debug",
			"runtime": {
				"backend": "egl",
				"config": {
					"width": 1920,
					"height": 1080,
					"cursor_theme": "DMZ-White"
				},
				"install_dependent_packages": true,
				"artifact_source": "github",
				"github_owner": "toyota-connected",
				"github_repo": "ivi-homescreen",
				"github_workflow": "flutter-auto-linux.yml",
				"github_artifact": "flutter-auto-${BACKEND}-dbg.amd64.deb.zip"
			},
			"overwrite-existing": true,
			"custom-device": {
				"id": "desktop-auto",
				"label": "Toyota flutter-auto",
				"sdkNameAndVersion": "flutter-auto x86_64",
				"platform": "linux-x64",
				"enabled": true,
				"ping": ["bash", "-c", "loginctl show-session $(awk '/tty/ {print $1}' <(loginctl)) -p Type"],
				"pingSuccessRegex": "Type=wayland",
				"postBuild": null,
				"install": ["bash", "-c", "mkdir -p /tmp/${appName}/data/flutter_assets && cp -r ${BUNDLE_FOLDER}/* /tmp/${appName} && cp -r ${localPath}/* /tmp/${appName}/data/flutter_assets"],
				"uninstall": ["rm", "-rf", "tmp/${appName}"],
				"runDebug": ["flutter-auto", "--j=${FLUTTER_WORKSPACE}/.flutter-auto/default_config.json", "--b=/tmp/${appName}"],
				"forwardPort": null,
				"forwardPortSuccessRegex": null,
				"screenshot": null
			}
		},
		{
			"id": "AGL-qemu",
			"type": "qemu",
			"arch": "x86_64",
			"flutter_runtime": "debug",
			"runtime": {
				"config": {
					"window_type": "BG",
					"width": 1920,
					"height": 1080,
					"fullscreen": true
				},
				"install_dependent_packages": true,
				"relative_path": ".agl/agl-image-flutter-runtime${FLUTTER_RUNTIME}-qemux86-64.wic.vmdk",
				"artifact_source": "github",
				"github_owner": "meta-flutter",
				"github_repo": "meta-flutter",
				"github_workflow": "kirkstone-agl-x86_64.yml",
				"github_artifact": "agl-image-flutter-runtime${FLUTTER_RUNTIME}-qemux86-64-linux",
				"ovmf_path": "/usr/share/ovmf/OVMF.fd",
				"cmd": "qemu-system-x86_64",
				"args": "-enable-kvm -m 2048 -bios ${OVMF_PATH} -hda ${QEMU_IMAGE} -cpu kvm64 -cpu qemu64,+ssse3,+sse4.1,+sse4.2,+popcnt -vga virtio -show-cursor -device virtio-rng-pci -serial mon:stdio -serial null -soundhw hda -device virtio-net-pci,netdev=net0,mac=52:54:00:12:35:02 -netdev user,id=net0,hostfwd=tcp::2222-:22,hostfwd=tcp::1234-:1234"
			},
			"overwrite-existing": true,
			"custom-device": {
				"id": "AGL-qemu",
				"label": "AGL x86_64 QEMU Image",
				"sdkNameAndVersion": "agl-image-flutter-runtime${FLUTTER_RUNTIME}-qemux86-64.wic.vmdk",
				"platform": "linux-x64",
				"enabled": true,
				"ping": [
					"bash", "-c", "(echo >/dev/tcp/localhost/2222) &>/dev/null && echo \"open 2222\" || echo \"close 2222\""
				],
				"pingSuccessRegex": "open 2222",
				"postBuild": [
					"bash", "-c", "mkdir -p ${localPath}/../../.flutter-auto/data/flutter_assets && cp -r ${localPath}/* ${localPath}/../../.flutter-auto/data/flutter_assets && cp -r ${FLUTTER_WORKSPACE}/.agl/default_config.json ${localPath}/../../.flutter-auto/ && ssh -p 2222 -t -oBatchMode=yes root@localhost passwd -d agl-driver"
				],
				"uninstall": [
					"bash", "-c", "ssh -p 2222 -t -t -oBatchMode=yes agl-driver@localhost rm -rf \"/tmp/${appName}\""
				],
				"install": [
					"bash", "-c", "ssh -p 2222 -t -t -oBatchMode=yes agl-driver@localhost mkdir -p \"/tmp/${appName}/data/flutter_assets\" && scp -r -P 2222 ${localPath}/../../.flutter-auto/* agl-driver@localhost:/tmp/${appName}"
				],
				"runDebug": [
					"ssh", "-t", "-t", "-p", "2222", "-oBatchMode=yes", "agl-driver@localhost",
					"flutter-auto",
					"--j=/tmp/${appName}/default_config.json",
					"--b=/tmp/${appName}",
					"--observatory-host=0.0.0.0",
					"--observatory-port=1234"
				],
				"forwardPort": null,
				"forwardPortSuccessRegex": null,
				"screenshot": null
			}
		}
	],
	"repos": [
		{
			"uri": "https://github.com/flutter/gallery.git",
			"branch": "master",
			"rev": "9eb785cb997ff56c46e933c1c591f0a6f31454f6",
			"pubspec_path": "gallery"
		},
		{
			"uri": "git@github.com:meta-flutter/tests.git",
			"branch": "main"
		},
		{
			"uri": "https://github.com/meta-flutter/flutter_animated_background.git",
			"branch": "meta-flutter",
			"pubspec_path": "flutter_animated_background/example"
		},
		{
			"uri": "https://github.com/mogol/flutter_secure_storage.git",
			"branch": "develop",
			"rev": "e716593352b80330e05729486eade7c2167d3c71",
			"pubspec_path": "flutter_secure_storage/flutter_secure_storage/example"
		},
		{
			"uri": "https://github.com/felipeerias/flutter_homescreen.git",
			"branch": "main",
			"pubspec_path": "flutter_homescreen"
		},
		{
			"uri": "https://github.com/bernardpumped/ped.git",
			"branch": "agl",
			"pubspec_path": "ped"
		},
		{
			"uri": "https://gerrit.automotivelinux.org/gerrit/apps/flutter-dashboard.git",
			"branch": "master",
			"pubspec_path": "flutter-dashboard"
		},
		{
			"uri": "https://gerrit.automotivelinux.org/gerrit/apps/flutter-hvac.git",
			"branch": "master",
			"pubspec_path": "flutter-hvac"
		},
		{
			"uri": "https://gerrit.automotivelinux.org/gerrit/apps/flutter-instrument-cluster.git",
			"branch": "master",
			"pubspec_path": "flutter-instrument-cluster"
		},
		{
			"uri": "https://gerrit.automotivelinux.org/gerrit/apps/flutter-mediaplayer.git",
			"branch": "master",
			"pubspec_path": "flutter-mediaplayer"
		},
		{
			"uri": "https://gerrit.automotivelinux.org/gerrit/apps/flutter-navigation.git",
			"branch": "master",
			"pubspec_path": "flutter-navigation"
		}
	]
}