diff options
author | 2019-04-11 15:31:33 +0200 | |
---|---|---|
committer | 2019-05-20 15:18:42 -0700 | |
commit | 3635b88a18de43bbdd2373259ac65c02bc63c139 (patch) | |
tree | d3f83a07a32230b938b700cc59419c8c85f42282 /docs/part-1/install-sdk.md | |
parent | 8e5d6918c1a51ae3e948b95c30a357c700821e39 (diff) |
Various review edits for XDS
Took care of review comments from Sebastien
to clear up some terminlogy, update the
create-app-workflow.png image to include
declaring a project. Fixed a link to the
XDS user guide to be guppy-specific.
Included more explanation regarding
aborting an ongoing installation.
v2: squased version due to files being (re-)moved
Change-Id: I48c20d8e0b105f1e26b68b574b2c5d2b56eecb61
Signed-off-by: Scott RifenbarK <srifenbark@gmail.com>
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Diffstat (limited to 'docs/part-1/install-sdk.md')
-rw-r--r-- | docs/part-1/install-sdk.md | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/docs/part-1/install-sdk.md b/docs/part-1/install-sdk.md new file mode 100644 index 0000000..50a8b10 --- /dev/null +++ b/docs/part-1/install-sdk.md @@ -0,0 +1,164 @@ +# AGL SDKs + +To build your AGL services or AGL applications using XDS, +you must install a Software Development Kit (SDK) that +matches your target/board. + +An SDK is a package that includes all the tools you need +to cross-build and cross-debug your service or application. +You install an SDK by running the SDK Installer. + +You can build an AGL SDK Installer for your board or you can download +a pre-built installer. + +This section describes how you can download a pre-built SDK +Installer using either the command line or the XDS Dashboard. +For information on how to build an SDK Installer, see the +"[Download or Build Your SDK Installer](../../../../getting_started/reference/getting-started/app-workflow-sdk.html)" +section. + +<!-- section-note --> +**NOTES:** +- In order to use the command line or the XDS Dashboard + to download an SDK Installer, you must + have the XDS Client set up in your toolchain (i.e. 'xds-cli'). + If you did not install 'xds-cli', see the + "[Client Part](client-part.html)" section for instruction on how + to install XDS UI. + +- See the + "[xds-server](../part-2/1_xds-server/0_abstract.html)" chapter + for more information on SDK management. +<!-- end-section-note --> + +## Command Line Operations + +This section describes how to download and install an SDK, +abort an installation, install an SDK from a local directory, +and view all installed SDKs. + +### Download and Install an SDK Using the Command Line + +Use the following commands to choose and install a pre-built SDK +Installer: + +```bash +# List all available SDKs +xds-cli sdks ls -a + +List of available SDKs: +ID NAME STATUS VERSION ARCH +ec15afe0 AGL-release-eel-4.99.4-raspberrypi3 Not Installed 4.99.4 armv7vehf-neon-vfpv4 +944d2d5a AGL-snapshots-master-latest-intel-corei7-64 Not Installed 4.99.3+snapshot corei7-64 +cf3a4365 AGL-release-dab-4.0.2-qemux86-64 Not Installed 4.0.2 corei7-64 +d65fe750 AGL-release-eel-latest-qemux86-64 Not Installed 4.99.3 corei7-64 +a0ae663d poky-agl-corei7-64-3.99.1+snapshot Installed 3.99.1+snapshot corei7-64 +87f0400b AGL-release-dab-3.99.3-m3ulcb-nogfx Installed 3.99.3 aarch64 +8c2f2841 AGL-release-dab-4.0.2-dragonboard-410c Not Installed 4.0.2 aarch64 +... + +# Download and Install an SDK +xds-cli sdks install d65fe750 + +Installation of 'AGL-release-eel-latest-qemux86-64' SDK successfully started. +Downloading poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-4.99.5.sh ... +--2018-01-02 11:22:23-- https://download.automotivelinux.org/AGL/release/eel/latest/qemux86-64/deploy/sdk/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-4.99.5.sh +Resolving download.automotivelinux.org (download.automotivelinux.org)... 199.19.213.77 +Connecting to download.automotivelinux.org (download.automotivelinux.org)|199.19.213.77|:443... connected. +HTTP request sent, awaiting response... 200 OK +Length: 665996704 (635M) [application/x-sh] +Saving to: ‘/tmp/tmp.wuQzLdImCS/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-4.99.5.sh’ + + 0K .......... .......... .......... .......... .......... 0% 82,7K 2h11m + 50K .......... .......... .......... .......... .......... 0% 89,1K 2h6m + 100K .......... .......... .......... .......... .......... 0% 82,0K 2h8m +... + 50300K .......... .......... .......... .......... .......... 99% 2,15M 0s + 650350K .......... .......... .......... ....... 100% 4,04M=10m35s + +2018-01-02 12:17:06 (1024 KB/s) - ‘/tmp/tmp.CWyEj3z76Q/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-4.99.5.sh’ saved [665996704/665996704] + +Automotive Grade Linux SDK installer version 4.99.5 +=================================================== +You are about to install the SDK to "/xdt/sdk/poky-agl/4.99.5/corei7-64". Proceed[Y/n]? Y +Extracting SDK....................................................................................................................done +Setting it up...done +SDK has been successfully set up and is ready to be used. +Each time you wish to use the SDK in a new shell session, you need to source the environment setup script e.g. + $ . /xdt/sdk/poky-agl/4.99.5/corei7-64/environment-setup-corei7-64-agl-linux + +SDK ID d65fe750-d3a7-38f5-83d8-3d3806054f8d successfully installed. +``` + +### Abort an Installation that is in Progress + +To abort an ongoing installation (i.e. the `xds-cli sdks install d65fe750` +in this example), use +the `ctrl-C` key sequence. `Ctrl-C` only stops the XDS Client (`xds-cli`). +The download or installation process running in the background +is not stopped. + +In such cases, the `xds-cli sdks ls` command results in an +`Installing` appearing in the STATUS column for all running installations. + +If for some reason you need to abort, use the `sdks abort` command: + +```bash +xds-cli sdks abort -id d65fe750 +``` + +### Install an SDK Using a Local SDK Package or File + +If you have an SDK Installer that is already local to your system, +you can use the command line to install it from your local directory: + +```bash +xds-cli sdks install --file $HOME/xds-workspace/sdks/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-corei7-64-toolchain-4.99.5.sh +``` + +<!-- section-note --> +**NOTE:** +Installation based on a local SDK Installer is only supported when the +SDK Installer is in the `$HOME/xds-workspace/sdks` directory. +<!-- end-section-note --> + +### List Installed SDKs + +To list the installed SDKs, use the following command: + +```bash +xds-cli sdks ls + +List of installed SDKs: +ID NAME STATUS VERSION ARCH +e45ac787 AGL-corei7-64-4.99.5+snapshot Installed 4.99.5 x86_64 +d65fe750 AGL-release-eel-latest-qemux86-64 Installed 4.99.3 corei7-64 +``` + +## Install an SDK Using the XDS Dashboard + +Follow these steps to locate, download, and install an SDK +using the XDS Dashboard: + +1. Open the XDS Dashboard in a Web Browser and select + `SDKs` in left-hand menu. + +2. Switch to `SDKs MANAGEMENT` view. + Following is an example: + + ![](../part-1/pictures/xds-dashboard-sdks-mgt.png){:: style="margin:auto; display:flex"} + +3. Use filter boxes to find the SDK you want to install. + +4. Click on the "plus" icon in the "Actions" column to + start the installation. + + The SDK Installer downloads and the installation process begins. + In can take several minutes for the installation to complete. + Following is an example of the output: + + ![](../part-1/pictures/xds-dashboard-sdks-install.png){:: style="margin:auto; display:flex"} + +**NOTE:**<\br> +If for some reason you need to abort an ongoing SDK installation, +you can do so by clicking the `CANCEL` button. |