Emulator

  OpenEmbedded can generate images for various emulators. Hence, it is very easy to compile AsteroidOS for the “qemux86” target with: . ./prepare-build.sh qemux86 bitbake asteroid-image The preferred emulator is actually VirtualBox. You can open VBox, create a new virtual machine based on Linux 2.6 (32-bit) with 1024 MB of RAM and use the...

Code of Conduct

We believe that our mission is best served in an environment that is friendly, safe, and accepting; free from intimidation or harassment. Towards this end, certain behaviors and practices will not be tolerated. tl;dr Be respectful. We’re here to help: Abusive behavior is never tolerated. Violations of this code may result in swift and...

Licenses

An AsteroidOS image is made of plenty of components and it’s hard to describe the full details of the licenses that are in used in the system. When building the system from sources with OpenEmbedded, one can find the exhaustive set of licenses in the build/tmp-glibc/deploy/licenses directory. In order to give a very general...

Building AsteroidOS

If you decide to compile AsteroidOS from source be aware that it’s a simple process but the first build might take you a lot of time. Report any problem to the issues tracker: Building Start by cloning the main repository using the following command: git clone https://github.com/AsteroidOS/asteroid.git cd asteroid/ This repository only contains a...

Translating AsteroidOS

AsteroidOS translations, aside from the app name, are managed through Weblate, a Free/Open Source web translation platform. To be able to use it, you will have to register an account, although you can also log in through a few popular third-party services. The rest of this page assumes you have an account. Updating translations...

Watchfaces creation

Watchface creation is fairly simple, requiring only QML knowledge. This guide will walk you through the steps. Preparing watchface creation First, clone the https://github.com/AsteroidOS/asteroid-launcher repository as it contains all watchfaces. Then, navigate to the watchfaces directory. In here, copy 000-default-digital.qml to a new file to use as a base for watchface creation. Testing your...

Creating an Asteroid App

The app creation process of AsteroidOS needs a Software Development Kit generated by OpenEmbedded. You can either grab a prebuilt SDK here (this is a self-contained script) and install it on your system or you can build it yourself as follow. Building the Cross compilation Toolchain If you’ve already got an OpenEmbedded build directory...

Porting Status

This page aims at gathering info about the currently supported platforms and porting efforts. Android Wear The Android Wear smartwatches are the most widespread and easy to support. The source code of their kernels is usually easily available and the drivers can be supported with libhybris. Those watches are the current priority of AsteroidOS....

Porting Guide

An AsteroidOS hardware adaptation layer consists of : OpenEmbedded recipes describing the compilation of the various HW adaptation components. An appropriate vendor kernel able to boot the watch’s SoC and including the required drivers. A set of Android Wear’s proprietary binary blobs used through libhybris in order to access some of the Android’s HALs....

SSH

By default, you can get a remote shell on you smartwatch with the Android Debug Bridge tool and the “adb shell” command. However this shell suffers from a many limitations and you might prefer to get a standard SSH connection. To do so you need to setup a TCP connection with your watch. The...