getting-started: add SDK quick start guide

Change-Id: I4a6d20d1abf63324f541933d3b78a8d781e3044e
Signed-off-by: Stephane Desneux <stephane.desneux@iot.bzh>

1 files changed, 75 insertions, 0 deletions

diff --git a/getting-started/setup-sdk-environment.md b/getting-started/setup-sdk-environment.md
new file mode 100644
index 0000000..cea672e
--- /dev/null
+++ b/getting-started/setup-sdk-environment.md
@@ -0,0 +1,75 @@
+# AGL SDK Quick Setup
+
+ This tutorial explains how to quickly setup an environment suitable to building and packaging AGL Applications using the SDK and a Docker container.
+
+The current tutorial has been tested on Linux, but may work with a few adjustments for Windows or MacOS.
+
+## Step 1: Install Docker
+
+First install docker on your host, if not already done. General instructions for Linux are available on the [Docker Site](https://docs.docker.com/engine/installation/linux/). 
+
+## Step 2: install the "Generic AGL Worker" Docker Image
+
+The Docker image for AGL Worker can be rebuilt using the scripts published here: [https://github.com/iotbzh/agl-docker-worker](https://github.com/iotbzh/agl-docker-worker).
+
+A pre-built image is available on IoT.bzh public site and can be used directly.
+
+First, download and load the image in your local Docker instance:
+```
+# wget -O - http://iot.bzh/download/public/2016/docker/docker_agl_worker-2.1.tar.xz | docker load
+# docker images
+REPOSITORY                              TAG                 IMAGE ID            CREATED             SIZE
+docker.automotivelinux.org/agl/worker   2.1                 42009148bc03        2 days ago          926.9 MB
+```
+
+Then, use the 'create_container' script to start a new, fresh container based on the AGL Worker image:
+
+```
+# git clone https://github.com/iotbzh/agl-docker-worker
+# cd agl-docker-worker
+# ./create_container 0
+# docker ps
+CONTAINER ID        IMAGE                                       COMMAND                  CREATED             STATUS              PORTS                                                                                        NAMES
+4fb7c550ad75        docker.automotivelinux.org/agl/worker:2.1   "/usr/bin/wait_for_ne"   33 hours ago        Up 33 hours         0.0.0.0:2222->22/tcp, 0.0.0.0:69->69/udp, 0.0.0.0:8000->8000/tcp, 0.0.0.0:10809->10809/tcp   agl-worker-odin-0-sdx
+```
+
+Note that the script 'create_container' will instantiate a new container and will share some volumes with the host:
+* /xdt (the build directory inside the container) is stored in ~/ssd/xdt_$ID (specific to instance ID)
+* /home/devel/mirror is stored in ~/ssd/localmirror_$ID (specific to instance ID)
+* /home/devel/share => points to  ~/devel/docker/share (shared by all containers)
+
+## Step 3: install the AGL SDK for your target
+
+Here, we assume that we just built an image 'agl-demo-platform-crosssdk' using the Yocto build procedure documented in the [Getting Started](./) section of the documentation.
+
+So we can copy such file to the shared volume.
+
+For example, we could have built the SDK from another worker container listening with SSH on port 2223:
+
+```
+$ create_container 1
+$ ssh -p 2223 devel@mybuilder.local
+... [ prepare build environment ] ...
+# bitbake agl-demo-platform-crosssdk
+... [ build happens in /xdt/build ] ...
+# cp /xdt/build/tmp/deploy/sdk/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-cortexa15hf-neon-toolchain-3.0.0+snapshot.sh ~/share
+```
+
+then login to the first "SDK Container" and install the SDK:
+
+```
+$ ssh -p 2222 devel@mysdk.local
+# install_sdk ~/share/poky-agl-glibc-x86_64-agl-demo-platform-crosssdk-cortexa15hf-neon-toolchain-3.0.0+snapshot.sh
+```
+
+## Step 4: build your application
+
+You're ready to go: get the sources, run the builds ...
+
+```
+# git clone <your repo for your app>
+# cd <your app>
+# cmake; make; make package
+```
+
+