Remove porter reference from meta-agl

* Remove, from recipes, reference to porter, gen2, krogoth.
* cleanup mardown from reference to porter.
* cleanup markdown (markdownlint score 0).

Change-Id: I70b9880fc52ef3c848da588d3a256fa8eee48606
Signed-off-by: Ronan Le Martret <ronan.lemartret@iot.bzh>

1 files changed, 3 insertions, 408 deletions

diff --git a/README-AGL.md b/README-AGL.md
index 146d6ff16..9ae0ee1e9 100644
--- a/README-AGL.md
+++ b/README-AGL.md
@@ -1,7 +1,7 @@
 ?README-AGL.md: The Automotive Grade Linux Distribution
 ======================================================
 
-AGL is creating an automotive specific Linux distribution (AGL UCB)
+[AGL](https://www.automotivelinux.org/) is creating an automotive specific Linux distribution (AGL UCB)
 that unifies the software that has been written in a number of places already,
 such as GENIVI and Tizen IVI.
 
@@ -26,411 +26,6 @@ For information abount Getting started with AGL
 For information about contributing to the AGL Distro
     [here](https://wiki.automotivelinux.org/agl-distro/contributing)
 
-Quick start guide
------------------
-
-The latest version is available at [AGL wiki](https://wiki.automotivelinux.org/agl-distro/source-code) for the following targets:
-* [QEMU](https://wiki.automotivelinux.org/agl-distro/source-code)
-* [Renesas Porter board](https://wiki.automotivelinux.org/start/building_for_the_renesas_r-car_m2)
-* [Raspberry Pi 2/3](https://wiki.automotivelinux.org/agl-distro/agl-raspberrypi)
-
-To build an image from 'meta-agl'
-
-1. Prepare repo:
-     >      $ mkdir ~/bin
-     >      $ export PATH=~/bin:$PATH
-     >      $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
-     >      $ chmod a+x ~/bin/repo
-
-2. Get all layers:
-     >      $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
-     >      $ repo sync
-
-3. Check available targets and extensions, select target machine:
-     >      $ source meta-agl/scripts/aglsetup.sh -h
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter
-
-4. Build agl-image-ivi
-     >      $ bitbake agl-image-ivi
-
-To build the agl-demo-platform (as demo'ed @ALS) replace 3. and 4. with:
-3. Check available targets and extensions, select target machine:
-     >      $ source meta-agl/scripts/aglsetup.sh -h
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo [agl-appfw-smack] [agl-devel] [agl-netboot]
-
-4. Build agl-demo-platform
-     >      $ bitbake agl-demo-platform
-Note: this uses more layers and not only meta-agl
-
-AGL Layers and dependencies:
-----------------------------
-Check the README.md of the respective layers:
-- meta-agl              (= core, no UI)
-- meta-agl-demo    (= reference UI)
-- meta-agl-extra     (= extra components)
-
-In addition, the reference hardware (Renesas R-Car Gen2 / porter) has this dependency:
-
-URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas
-> branch:   agl-1.0-bsp-1.8.0
-> tested revision: 82611ccadef36ab0b8a6fd6fb1cf055e115f1ef5
-
-
-Supported Machines
-------------------
-
-Reference hardware:
-
-* QEMU (x86-64) - emulated machine: qemux86-64
-* Renesas R-Car Gen2 (R-Car M2) - machine: porter
-
-Community contributed hardware:
-
-* See: https://wiki.automotivelinux.org/agl-distro#supported_hardware
-
-
-Supported Target of bitbake
----------------------------
-
-meta-agl:
-
-* `agl-image-ivi` The baseline image of AGL Distributions (console only)
-
-* `agl-image-minimal` For internal use to develop distribution (experimental)
-* `agl-image-weston`  For internal use to develop distribution (experimental)
-
-meta-agl-demo:
-
-* `agl-demo-platform` The demo/reference image (with graphical UI)
-
-Run this command for a full list of machines, features and targets:
-     >       $ source ./meta-agl/scripts/aglsetup.sh -h
-
-
-Supposed Directory Tree of Layers to build
--------------------------------------------
-
-     >      $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
-     >      $ repo sync
-     >      $ tree -L 1
-	.
-	|-- meta-agl
-	|-- meta-agl-demo
-	|-- meta-agl-devel
-	|-- meta-agl-extra
-	|-- meta-amb
-	|-- meta-fsl-arm
-	|-- meta-fsl-arm-extra
-	|-- meta-intel
-	|-- meta-intel-iot-security
-	|-- meta-openembedded
-	|-- meta-qcom
-	|-- meta-qt5
-	|-- meta-raspberrypi
-	|-- meta-renesas
-	|-- meta-rust
-	|-- meta-security-isafw
-	|-- meta-ti
-	`-- poky
-	18 directories, 0 files
-
-
-Build a QEMU image
-------------------
-
-You can build a QEMU image using the following steps:
-
-(latest version here: https://wiki.automotivelinux.org/agl-distro/source-code)
-To build an image from 'meta-agl'
-
-1. Prepare repo:
-     >      $ mkdir ~/bin
-     >      $ export PATH=~/bin:$PATH
-     >      $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
-     >      $ chmod a+x ~/bin/repo
-
-2. Get all layers:
-     >      $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
-     >      $ repo sync
-
-3. Check available targets and extensions, select target machine:
-     >      $ source meta-agl/scripts/aglsetup.sh -h
-     >      $ source meta-agl/scripts/aglsetup.sh -m qemux86-64
-
-  Alternatively, to enable the reference UI feature ('agl-demo'):
-     >      $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo
-
-  Alternatively, to also enable also the security framework ('agl-appfw-smack'):
-     >      $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo agl agl-appfw-smack
-
-  Alternatively, to also enable debugging tools ('agl-devel') and the network-boot (nbd) capabilities ('agl-netboot'):
-     >      $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo agl agl-appfw-smack agl-devel agl-netboot
-
-4. Build agl-image-ivi
-     >      $ bitbake agl-image-ivi
-
-  or alternatively, if you enabled the 'agl-demo' feature:
-     >      $ bitbake agl-demo-platform
-
- - If you want to run QEMU directly as VM in Virtual Box or your other favorite VM software then add this line to your "conf/local.conf" file.
-     >      IMAGE_FSTYPES += "wic.vmdk"
-
-5. Run in the emulator
-     >      $ runqemu agl-image-ivi qemux86-64
-     >      or
-     >      $ runqemu agl-demo-platform qemux86-64
-
-   For a large screen:
-     >      $ runqemu agl-image-ivi qemux86-64 bootparams="uvesafb.mode_option=1280x720-32"
-
-   To extend the amount of memory, add to runqemu:
-     qemuparams="-m 512"
-     >      $ runqemu agl-image-ivi qemux86-64 qemuparame="-m 512" bootparams="uvesafb.mode_option=1280x720-32"
-
-
-   To separate console from VGA screen (to avoid corrupt screen while booting),
-   add to runqemu:
-     serial
-     >      $ runqemu agl-image-ivi qemux86-64 bootparams="uvesafb.mode_option=1280x720-32" serial
-
-	**Or use the virtual disk in Virtual Box from this location:**
-	> tmp/deploy/images/qemux86-64/agl-demo-platform-qemux86-64.wic.vmdk
-
-6.  Some weston samples are available from weston terminal (click top left icon).
-   Check the folder `/opt/AGL/ALS2016`.
-
-Build a R-Car M2 (porter) image
--------------------------------
-
-### Software setup
-
-NOTE: You will need to download the matching binary driver package from renesas.
-      As of this writing, the version from 20151228.
-      The main URL to retrieve these is:
-
- -   https://www.renesas.com/en-eu/solutions/automotive/rcar-demoboard.html
-
-      As of this writing, the necessary libary and driver packages linked to
-      by above site are:
-      - The subpage for the library is:
-	      - https://www.renesas.com/en-eu/software/D3017410.html (registration/login required)
-
-      - The sub-page for the driver is:
-	      - https://www.renesas.com/en-eu/media/secret/solutions/automotive/rcar-demoboard/R-Car_Series_Evaluation_Software_Package_of_Linux_Drivers-20151228.zip
-
-      !!! The files need to be in `${HOME}/Downloads` ( `$XDG_DOWNLOAD_DIR` ) !!!
-
-#### Getting Source Code and Build image
-
-(latest version here: https://wiki.automotivelinux.org/agl-distro/source-code)
-To build an image from 'meta-agl' only:
-
-1. Prepare repo:
-     >      $ mkdir ~/bin
-     >      $ export PATH=~/bin:$PATH
-     >      $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
-     >      $ chmod a+x ~/bin/repo
-
-2. Get all layers:
-     >      $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
-     >      $ repo sync
-
-3. Check available targets and extensions, select target machine:
-     >      $ source meta-agl/scripts/aglsetup.sh -h
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter
-
-  Alternatively, to enable the reference UI:
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo
-
-  Alternatively, to also enable also the security framework:
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl agl-appfw-smack
-
-  Alternatively, to also enable debugging tools and the network-boot (nbd) capabilities:
-     >      $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl agl-appfw-smack agl-devel agl-netboot
-
-4. (optional) edit conf/local.conf   )* see below
-     >        $ vi conf/local.conf
-
-5. Build agl-image-ivi
-     >        $ bitbake agl-image-ivi
-
-  or alternatively, if you enabled the 'agl-demo' feature:
-     >      $ bitbake agl-demo-platform
-
-
-)* :
-
- 4 .  Optional edits to conf/local.conf
-
- *  If you want to use multimedia accelerations, uncomment
-    manually 4 `IMAGE_INSTALL_append_porter` in conf/local.conf.
-
-    >     #IMAGE_INSTALL_append_porter = " \
-    >     #    gstreamer1.0-plugins-bad-waylandsink \
-    >     #    "
-    >     #IMAGE_INSTALL_append_porter = " \
-    >     #    gstreamer1.0-plugins-base-videorate \
-    >     ...
-    >     #"
-    >     #IMAGE_INSTALL_append_porter = " \
-    >     #    libegl libegl-dev libgbm-dev \
-    >     ...
-    >     #    "
-    >     #IMAGE_INSTALL_append_porter = " \
-    >     #    packagegroup-rcar-gen2-multimedia \
-    >     ...
-    >     #    "
-
-* Also it is needed to uncomment this:
-    >     #MACHINE_FEATURES_append = " multimedia"
-
-   This `multimedia` MACHINE_FEATURES enables the meta-renesas's specific multimedia configuration.
-   The version of GStreamer1.0 which AGL distro will use is changed
-   to 1.2.3 (meta-renesas prefers it) over 1.4.1 (meta-agl default)
-   by this switch.
-
-* If you want to install various Qt5 examples, add below
-   configuration to your local.conf.
->      IMAGE_INSTALL_append = " \
->            packagegroup-agl-demo-qt-examples \
->        "
->        PACKAGECONFIG_append_pn-qtbase = " examples"
->
->  IMPORTANT NOTE:
->        To run examples with wayland-egl plugin,
->        use ``LD_PRELOAD=/usr/lib/libEGL.so <command>``.
->        If not, programs should not launch by error,
->        'EGL not available'.
-
-
-### Deployment (SDCARD)
-
-#### Instructions on the host
-
-1. Format SD-Card and then, create single EXT4 partition on it.
-
-2. Mount the SD-Card, for example `/media/$SDCARD_LABEL`.
-
-3. Copy AGL root file system onto the SD-Card
-   1. Go to build directory
-         >     $ cd $AGL_TOP/build/tmp/deploy/images/porter
-
-   2. Extract the root file system into the SD-Card
-         >     $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order \
-         >                --totals --directory=/media/$SDCARD_LABEL --file=agl-image-ivi-porter.tar.bz2
-
-   3. Copy kernel and DTB into the `/boot` of the SD-Card
-         >     $ sudo cp uImage uImage-r8a7791-porter.dtb /media/$SDCARD_LABEL/boot
-
-4. After the copy finished, unmount SD-Card and insert it into the SD-Card slot of the porter board.
-
-#### Instructions on the target
-
-NOTE: There is details about porter board [here](http://elinux.org/R-Car/Boards/Porter).
-
-NOTE: To boot weston on porter board, we need keyboard and mouse. (USB2.0 can be use for this)
-
-##### Change U-Boot parameters to boot from SD card
-
-1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot by hitting any key.
-
-  ``Debug serial settings are 38400 8N1. Any standard terminal emulator program can be used.**
-
-2. Set the follow environment variables and save them
->     => setenv bootargs_console console=ttySC6,${baudrate}
->     => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60
->     => setenv bootcmd_sd 'ext4load mmc 0:1 0x40007fc0 boot/uImage;ext4load mmc 0:1 0x40f00000 boot/uImage-r8a7791-porter.dtb'
->     => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} root=/dev/mmcblk0p1 rw rootfstype=ext4;run bootcmd_sd;bootm 0x40007fc0 - 0x40f00000'
->     => saveenv
-
-##### Boot from SD card
-
-1. After board reset, U-Boot is started and after a countdown, ...
-   Linux boot message should be displayed. Please wait a moment.
-
-2. Then weston is booted automatically, and weston-terminal appears.
-
-3. Have fun! :)
-
-### Deployment (TFTP/NFS)
-
-NOTE: These instructions are based on Embedded Linux Wiki, [here](http://www.elinux.org/R-Car/Boards/Yocto#Loading_kernel_via_TFTP_and_rootfs_via_NFS). And a Debian (wheezy, ip: 192.168.30.70) is used as the host for this instructions.
-
-#### Instructions on the host
-1. Setup a TFTP server
-   1. Install necessary packages
-         >     $ sudo apt-get install tftp tftpd-hpa
-
-   2. Go to build directory, and copy kernel and DTB into TFTP server root (default server dir: /srv/tftp)
-         >     $cd  $AGL_TOP/build/tmp/deploy/images/porter
-         >     $ sudo cp uImage uImage-r8a7791-porter.dtb /srv/tftp
-
-   3. Verify TFTP server is working
-         >     $ ls uImage
-           ls: cannot access uImage: No such file or directory
-
-         >     $ cd /tmp/
-         >     $ tftp 192.168.30.70
-         >     tftp> get uImage
-         >     Received 3583604 bytes in 0.2 seconds
-         >     tftp> q
-         >     $ ls uImage
-         >     uImage
-
-2. set NFS server
-   1. Install necessary packages
-         >     $ sudo apt-get install nfs-kernel-server nfs-common
-
-   2. Go to build directory, and extract the root file system into a dedicated directory (here we use /nfs/porter)
-         >     $ cd $AGL_TOP/build/tmp/deploy/images/porter
-         >     $ sudo mkdir -p /nfs/porter
-         >      $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order \
-         >       --totals --directory=/nfs/porter --file=agl-demo-platform-porter.tar.bz2
-
-   3. Edit /etc/exports
-         >     $ sudo vi /etc/exports
-         Add
-         >
-         >     /nfs/porter	*(rw,no_subtree_check,sync,no_root_squash,no_all_squash)
-         >
-	Save the file and exit.
-
-   4. Restart nfs service
-         >     $ sudo service nfs-kernel-server restart
-
-   5. Verify NFS server is working
-         >     $ sudo mount -t nfs 192.168.30.70:/nfs/porter /tmp/
-         >     $ ls /tmp
-         >     bin  boot  dev  etc  home  lib  media  mnt  proc  run  sbin  sys  tmp  usr  var
-
-#### Instructions on the target board
-
-NOTE: There is details about porter board [here](http://elinux.org/R-Car/Boards/Porter).
-
-NOTE: To boot weston on porter board, we need keyboard and mouse. (USB2.0 can be use for this)
-
-##### Change U-Boot parameters to boot from TFTP/NFS
-
-1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot by hitting any key.
-
-  > Debug serial settings are 38400 8N1. Any standard terminal emulator program can be used.
-
-2. Set the follow environment variables and save them
->     => setenv ipaddr <board-ip>
->     => setenv serverip <host-ip>
->     => setenv bootargs_console console=ttySC6,${baudrate}
->     => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60
->     => setenv bootcmd_net 'tftp 0x40007fc0 uImage; tftp 0x40f00000 uImage-r8a7791-porter.dtb'
->     => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} ip=${ipaddr} root=/dev/nfs nfsroot=${serverip}:/nfs/porter,vers=3;run bootcmd_net;bootm 0x40007fc0 - 0x40f00000'
->     => saveenv
-
-    Replace <board-ip> with a proper IP address for the board, like 192.168.30.60.
-    Replace <host-ip> with the IP address of the host, here we use 192.168.30.70.
-
-##### Boot from TFTP/NFS
-
-1. After board reset, U-Boot is started and after a countdown, ...
-   Linux boot message should be displayed. Please wait a moment.
-2. Then weston is booted automatically, and weston-terminal appears.
-3. Have fun! :)
+For more documentation about AGL:
 
+* [docs.automotivelinux.org](http://docs.automotivelinux.org)