====== **IMPORTANT** ======

This quickstart is no longer maintained. To get the latest instructions please consult the Readme of each CIP Core reference implementation:
  * [[https://gitlab.com/cip-project/cip-core/deby|Deby]]
  * [[https://gitlab.com/cip-project/cip-core/isar-cip-core|Isar-cip-core]]


===== CIP Core Quickstart =====

In this quickstart we will focus on building and running CIP core (tiny profile, [[http://events17.linuxfoundation.org/sites/events/files/slides/ISAR-DEBY-OSSJ2017_r10.pdf|Deby]] implementation) on the iWave RZ/G1M Qseven Development Kit. You can find the instructions for each reference board in the corresponding README files (deby/poky/meta-cip-<board>/README.<board>.txt in the [[https://gitlab.com/cip-project/cip-core/deby|source code]]).

=== Step 1: Clone the CIP Core source repository ===

This step downloads the cip-core metadata which is MIT licensed.
<code>
host$ git clone https://gitlab.com/cip-project/cip-core/deby.git
</code>

=== Step 2: Build CIP Core using KAS ===

The CIP Core release v1.0 requires [[https://github.com/siemens/kas|KAS]] for preparing a docker-based poky build environment. Make sure that you have docker installed and configured it to use the [[https://docs.docker.com/engine/userguide/storagedriver/overlayfs-driver/|overlay2 storage driver]]. Your host kernel also needs to support overlayfs. Then run a KAS container and build the file system. Note that the first time docker will have to pull the KAS image from the cloud.
<code>
host$ docker run -v $PWD/deby:/deby -e USER_ID=`id -u $USER` -e http_proxy=$http_proxy -e https_proxy=$https_proxy -it kasproject/kas:0.10.0 sh
</code> 
Build the KAS project file for the iWave RZ/G1M Qseven Development Kit.
<code>
docker$ cd /deby/poky/
docker$ kas build --target core-image-minimal meta-cip-iwg20m/kas-iwg20m.yml
</code>
After the build is finished you should be able to get the generated filesystem image as follows.
<code>
host$ ls build/tmp/deploy/images/iwg20m/
        core-image-minimal-iwg20m.cpio.gz
        core-image-minimal-iwg20m.tar.gz
        uImage
        uImage-r8a7743-iwg20m.dtb
        u-boot.bin
</code>
=== Step 3: Run the generated filesystem image ===
 
Prepare SD Card partitions using kit’s guide and install the generated binaries.
<code>
host$ cp -L uImage /media/<user>/BOOT/uImage
host$ cp -L uImage-r8a7743-iwg20m.dtb /media/<user>/BOOT/r8a7743-iwg20m_q7.dtb
host$ sudo rm -rf /media/<user>/ROOT/*
host$ sudo tar xvf core-image-minimal-iwg20m.tar.gz -C /media/<user>/ROOT/
</code>
Insert the card on the micro-sd slot (on the upper SOM) and interrupt u-boot on the serial console to setup u-boot’s boot command.

<code>
$ picocom -b 115200 /dev/ttyUSB0
  iWave-G20M > setenv bootcmd_msd 'run bootargs_msd;run fdt_check;mmc dev 1;fatload mmc 1 ${loadaddr} ${kernel};fatload mmc 1 ${fdt_addr} ${fdt_file};bootm ${loadaddr} - ${fdt_addr}'
  iWave-G20M > setenv bootargs_msd 'setenv bootargs ${bootargs_base} root=/dev/mmcblk0p2 rw rootfstype=ext3 rootwait'
  iWave-G20M > saveenv
  iWave-G20M > run bootcmd_msd
</code>

You should get a similar boot log to the one stored [[https://gitlab.com/cip-project/cip-core/deby/blob/master/poky/meta-cip-iwg20m/README.IWG20M.txt|here]].