Awesome

This is a modern operating system for next generation interactive device, and it embraces Web community, uses JavaScript as the application language.

Get Started

To start with compiling YODAOS, a Linux is required, we recommend the followings distributions:

• Ubuntu 16.04
• Centos 7

For Ubuntu:

$ apt-get install build-essential subversion libncurses5-dev zlib1g-dev gawk gcc-multilib flex git-core gettext libssl-dev unzip texinfo device-tree-compiler dosfstools libusb-1.0-0-dev

For Centos 7, the install command-line is:

$ yum install -y unzip bzip2 dosfstools wget gcc gcc-c++ git ncurses-devel zlib-static openssl-devel svn patch perl-Module-Install.noarch perl-Thread-Queue
# And the `device-tree-compiler` also needs to install manually:
$ wget http://www.rpmfind.net/linux/epel/6/x86_64/Packages/d/dtc-1.4.0-1.el6.x86_64.rpm
$ rpm -i dtc-1.4.0-1.el6.x86_64.rpm

Download Source

Click http://openai-corp.rokid.com, and do register as Rokid Developer.

Then, go SSH Settings to config your local public key.

https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/

Install the repo cli

YODAOS uses the repo command-line to manage the source tree:

Repo unifies Git repositories when necessary, performs uploads to the Gerrit revision control system, and automates parts of the Android development workflow. Repo is not meant to replace Git, only to make it easier to work with Git in the context of Android. The repo command is an executable Python script that you can put anywhere in your path.

Follow the below commands to install manually:

$ curl https://raw.githubusercontent.com/yodaos-project/yodaos/master/tools/repo > /usr/local/bin/repo
$ chmod 777 /usr/local/bin/repo

And use repo --help to test if installation is done.

Compile

When the repo cli is ready, follow the instruments to get the complete source of YODAOS:

$ repo init -u https://github.com/yodaos-project/yodaos.git -m manifest.xml --repo-url=http://openai-corp.rokid.com/tools/repo --no-repo-verify
$ .repo/manifests/tools/repo-username -u {your rokid developer username} # set your username to fetch source from gerrit
$ repo sync

The above takes few minutes, just be patient. The next step is to build out the OS image, let's take the example of Raspberry board:

$ cp -r products/yodaos/rbpi-3b-plus/configs/broadcom_bcm2710_rpi3b_plus_defconfig openwrt/.config
$ cd openwrt
$ make defconfig && make

The cp command is to select which board that you would build, the following are the boards config table:

Remember that make defconfig after you redo the copy on the specific board config.

Go compile & run for more details.

Children projects

The YODAOS is a group of children projects open sourced which mainly are:

BSP

• Kernel
  • kamino18
  • amlogic a113
• Uboot
  • kamino18
  • amlogic a113
  • raspberry

AIAL

• ai-libs-common includes the common libraries for AIAL.

System Service

• flora-dispatcher is the centered service for flora.
• yoda-speech-service is the speech service that talks to [Rokid][] ASR/NLP cloud.
• net_manager manages the networking.
• gsensor_service G-sensor service.
• powermanager_service manages the power.
• battery_service manages the battery.
• bluetooth_service provides the A2DP-SINK, A2DP-SOURCE and AVRCP functions.

Library

• flora is the PUB/SUB messaging library, also supports the request/response model for IPC.
• rklog rokid's logging library.
• httpdns httpdns library.
• httpsession http library based on CURL.
• librplayer MediaPlayer library based on SDL and ffmpeg.
• librokid-bt rokid's bluetooth library.
• librokid-bcmdhd-bt rokid's bluetooth library for bcmdhd.
• input-event The library controls the keyboard based on linux input API.
• lumenlight The LED library.

Framework

• ShadowNode is the Node.js runtime that implements most of core APIs and N-API-compatible.
• yoda.js is the application-layer of YODAOS, it's also the VUI framework for JavaScript.

Releases

This section describes how do YODAOS release and its lifecycle.

versions

YODAOS uses Semver 2.0 for versioning management, and we have lifecycles for major and minor.

• major: one release per 6 month, and all releases are stable.
• minor: one release per 1 month, and only the even ones are stable, namely 1.0.x, 1.2.x, 1.4.x.

We assume the 3rd Thursday at every month as YodaOS release date.

release requirements

Every release must contain the following parts:

• Repo manifest commit with specific version, for downloading the source code.
• Multiple platform images, includes:
  • Rokid Kamino18 soc.
  • AmLogic A113.
• Changelog describes what changes this updated.

stable and pre-versions

Stable version requires the complete tests on:

• Compatibility test suite
• Unit tests of modules and services
• Functional tests
• Integration tests

The above workload is in usual 2 weeks for the team, therefore we introduce pre-version, namely release candidates(RC) to track the stable releasing progress.

For stable version, we preserve 2 weeks at least to take the workload of full tests, and create a pre-version branch v1.2.x-rc. Once all the full tests are passed, then create a stable branch(v1.2.x) from release candidate branch(v1.2.x-rc).

Community

• YouTube

Contributing

YODAOS is a community-driven project that we accepts any improved proposals, pull requests and issues.

• For JavaScript development, go [yodart][] for details.
• For proposal, yodaos-project/evolution is the place where someone can submit pull request to propose something.

Documentation

• YodaOS Book

License

Apache 2.0