meta-congatec-x86
=================

This is a Congatec maitained x86 platform BSP.


Dependencies
  URI: git://git.openembedded.org/bitbake
  branch: dizzy

  URI: git://git.openembedded.org/openembedded-core
  layers: meta
  branch: dizzy

  URI: git://git.yoctoproject.org/meta-intel
  layers: intel
  branch: dizzy


Getting Sources (New Project)
  cd ~
  git clone git://git.yoctoproject.org/poky.git yocto -b dizzy
  cd ~/yocto
  git clone git://git.yoctoproject.org/meta-intel.git -b dizzy
  git clone https://git.congatec.com/x86/meta-congatec-x86.git -b dizzy

Configuration
  - Create build directory
      cd ~/yocto
      source oe-init-build-env ~/yocto/build

    This command create a new ~/yocto/build directory and jump there.

  - Edit conf/bblayers.conf to append a meta-congatec layer at end of BBLAYERS list.
         /home/honza/yocto/meta-yocto-bsp \
      +  /home/honza/yocto/meta-intel \
      +  /home/honza/yocto/meta-intel/meta-isg/meta-valleyisland \
      +  /home/honza/yocto/meta-intel/meta-tlk \
      +  /home/honza/yocto/meta-congatec-x86 \
         "

  - Edit conf/local.conf to include CGOS tools in your image. Append at the file end :
      IMAGE_INSTALL_append = " cgos"

    Change target platform from to congatec-qa3-64 (qemux86 is default):
         #MACHINE ?= "edgerouter"
         #
      +  MACHINE ?= "congatec-qa3-64"
         MACHINE ??= "qemux86"

    For parallel build append lines like following (example use with 4 core CPU) :
      BB_NUMBER_THREADS ?= "8"
      PARALLEL_MAKE ?= "-j 8"

    Accept and whitelist commercial licenses (check license files for details) :
      LICENSE_FLAGS_WHITELIST = "commercial"


Build
  Supported images - currently are supported following images :
    core-image-sato
    core-image-sato-sdk
    core-image-minimal

  Start build :
    bitbake <image-name>


Deploy
  WARNING: All on the USB Mass Storage data will be lost.
  Insert the USB Mass Storage to build machine.
  Check and save your USB Mass Storage's device node name to shell variable SD :
    dmesg | tail
      => sdb
    SD=/dev/sdb

  Copy image to the USB Mass Storage
    cd ~/yocto/build/tmp/deploy/images/congatec-qa3-64
    sudo dd if=core-image-minimal-congatec-qa3-64.hddimg of="$SD"
    sync

  Remove the USB Mass Storage (safely).


BIOS (QA3)
  Plug the USB Mass Storage to your target, power up and enter the BIOS Setup.

  Load BIOS defaults by stroke key F9 and accept by selecting option "Yes".
  Enter "Main" tab and check if you are using the latest BIOS release. Otherwise update the BIOS.

  In "Advanced -> CSM Configuration" check if a legacy boot method is enabled :
    "Boot Option filter" set to "[UEFI only]".

  Check boot method settings. In the "Boot" tab check :
    "Boot Priority Selection" is set to "[Device Based]".
  You should see now your USB Mass Storage divide detected as item "Boot Option #1".

  Save BIOS by stroke key F10 and accept by selecting option "Yes".
  Target is now  ready to boot the Yocto Project.


Testing
  Serial console shell interface is provided by default (115200 bps, no parity, 8bit).
  Check baseboard schametic for a prper connector location and pinning.


Check Congatec website http://congatec.com for more informations.


Maitainer
  Jan Rohacek, Congatec s.r.o, Plzen
  email : jan.rohacek-at-congatec.com