tree: 5890491dad7a81f775c7e46b23371c0c3ad6ec2a [path history] [tgz]
  1. README.md
  2. __init__.py
  3. _env.py
  4. ci20x11/
  5. shared/
src/starboard/contrib/creator/README.md

MIPS support

starboard/contrib/creator directory contains port of Cobalt for Creator CI20 platform: https://www.elinux.org/MIPS_Creator_CI20

Building Cobalt for CI20

Cobalt can be built for CI20 using LLVM toolchain (Clang and lld), GCC 4.9 and GCC MTI 6.3 toolchains. In all cases sysroot based on Debian is needed. For building Cobalt with Clang or GCC 4.9, Debian Jessie is used as sysroot, and for building with GCC MTI 6.3, sysroot is based on Debian Stretch due to dependance on newer versions of libstdc++. For this reason, Cobalt built with GCC MTI 6.3 toolchain can only be executed on CI20 platform with Debian Stretch or later.

Sysroot

Directory third_party/ci20 contains script mipsel-toolchain-sysroot-creator.sh, which will create Debian based sysroot. In addition this script will also build GCC 4.9 toolchain or download prebuilt GCC MTI 6.3 from https://codescape.mips.com.

In order to create sysroot and toolchain run:

./mipsel-toolchain-sysroot-creator.sh <toolchain>

toolchain argument can be:

clang - Creates sysroot based on Debian Jessie with addition of GCC 4.9 libs gcc_4-9 - Builds GCC 4.9 toolchain and creates sysroot based on Debian Jessie gcc_mti_6-3 - Downloads prebuilt MTI GCC 6.3 toolchain and creates sysroot based on Debian Stretch

Result will be a package:

mipsel_clang_jessie_sysroot.tgz - contains Debian Jessie sysroot, and required GCC libs mipsel_gcc_4-9_jessie_sysroot.tgz - contains built GCC 4.9 toolchain and Debian Jessie sysroot mipsel_gcc_mti_6-3_stretch_sysroot.tgz - contains downloaded GCC MTI 6.3 toolchain and Debian Stretch sysroot

Directory where this package is extracted should be exported as CI20_HOME.

export CI20_HOME=<PATH_TO_DIRECTORY_WHERE_PACKAGE_IS_EXTRACTED>

JavaScript engine

Default configuration for JavaScript engine is V8 with JIT enabled. Alternative configuration is to use mozjs-45, which has JIT disabled by defualt. Configuration with mozjs-45 is only available when building Cobalt with Clang.

Building

Follow all generic instructions from:

http://cobalt.foo/development/setup-linux.html

Building with Clang

Clang is the default toolchain for building Cobalt for CI20. Configuration files are located in creator/ci20x11.

Commands for building are:

cobalt/build/gyp_cobalt -C debug creator-ci20x11
ninja -j4 -C out/creator-ci20x11_debug all

cobalt/build/gyp_cobalt -C devel creator-ci20x11
ninja -j4 -C out/creator-ci20x11_devel all

cobalt/build/gyp_cobalt -C qa creator-ci20x11
ninja -j4 -C out/creator-ci20x11_qa cobalt

cobalt/build/gyp_cobalt -C gold creator-ci20x11
ninja -j4 -C out/creator-ci20x11_gold cobalt

Using mozjs-45 JavaScript engine:

cobalt/build/gyp_cobalt -C debug creator-ci20x11-mozjs
ninja -j4 -C out/creator-ci20x11-mozjs_debug all

cobalt/build/gyp_cobalt -C devel creator-ci20x11-mozjs
ninja -j4 -C out/creator-ci20x11-mozjs_devel all

cobalt/build/gyp_cobalt -C qa creator-ci20x11-mozjs
ninja -j4 -C out/creator-ci20x11-mozjs_qa cobalt

cobalt/build/gyp_cobalt -C gold creator-ci20x11-mozjs
ninja -j4 -C out/creator-ci20x11-mozjs_gold cobalt

Building with GCC 4.9

Configuration files for GCC build are located in creator/ci20x11/gcc/4.9

Commands for building are:

cobalt/build/gyp_cobalt -C debug creator-ci20x11-gcc-4-9
ninja -j4 -C out/creator-ci20x11-gcc-4-9_debug all

cobalt/build/gyp_cobalt -C devel creator-ci20x11-gcc-4-9
ninja -j4 -C out/creator-ci20x11-gcc-4-9_devel all

cobalt/build/gyp_cobalt -C qa creator-ci20x11-gcc-4-9
ninja -j4 -C out/creator-ci20x11-gcc-4-9_qa cobalt

cobalt/build/gyp_cobalt -C gold creator-ci20x11-gcc-4-9
ninja -j4 -C out/creator-ci20x11-gcc-4-9_gold cobalt

Building with GCC MTI 6.3

Configuration files for GCC build are located in creator/ci20x11/gcc/6.3.mti

Commands for building are:

cobalt/build/gyp_cobalt -C debug creator-ci20x11-gcc-6-3-mti
ninja -j4 -C out/creator-ci20x11-gcc-6-3-mti_debug all

cobalt/build/gyp_cobalt -C devel creator-ci20x11-gcc-6-3-mti
ninja -j4 -C out/creator-ci20x11-gcc-6-3-mti_devel all

cobalt/build/gyp_cobalt -C qa creator-ci20x11-gcc-6-3-mti
ninja -j4 -C out/creator-ci20x11-gcc-6-3-mti_qa cobalt

cobalt/build/gyp_cobalt -C gold creator-ci20x11-gcc-6-3-mti
ninja -j4 -C out/creator-ci20x11-gcc-6-3-mti_gold cobalt

Running Cobalt on CI20

Cobalt might complain about missing libraries on CI20 platform with stock Debian rootfs.

To check which libraries are missing, run:

ldd ./cobalt

And install missing libraries using apt-get.

Pulseaudio

Before running Cobalt on CI20, pulseaudio must be disabled.

a) Global config (all users): edit /etc/pulse/client.conf or b) Local config (single user): edit ~/.config/pulse/client.conf

Add following new line to client.conf: autospawn = no

Starting Cobalt

To start Cobalt on CI20, mount “out” directory on platform and run:

cd out/creator-ci20x11_gold
./cobalt

By default Cobalt will open youtube.com/tv page.

Notes about performance

Audio

With pulseaudio disabled, audio on youtube.com/tv is working OK, with occasional audible artifacts.

Video

Since CI20 still uses software video decoding, video performance is not good. Video playback will start, but most of the frames will be dropped.