Onion Omega2 Firmware Build System

This buildsystem for the LEDE Linux distribution has been modified by Onion Corporation to build firmware for the Onion Omega2 and Omega2+

Onion Corporation is not responsible for any damage to your device caused by using custom firmware or packages not built and released by Onion Corporation.

Notes

• Due to incompatibilities with recent kernel updates, building a firmware with the Ralink APSoC WiFi SoftAP driver will cause a kernel panic during boot
  • This can be fixed by reflashing the Omega's firmware using the Omega's Bootloader and Ethernet Expansion
  • We are working on a new implementation of the WiFi driver, stay tuned!
  • Fixed with release of Onion WiFi Warp Core driver
    • Available as an OpenWRT/LEDE package for systems running Linux Kernel 4.4.76
    • See this post for more details on the Warp Core

Additional Reading

• See CHANGELOG.md for a listing of the changes for each firmware version and build
• See DISCLAIMER.md for Onion's disclaimer regarding this build system

Using this Build System

This buildsystem can be used to create packages and firmware for the Omega2 device. There are two preferred ways to use the buildsystem:

1. Using the onion/omega2-source Docker image Recommended method
2. Running the build system on a Linux system

Using the Docker Image

The Docker image takes care of all environmental configuration and is the recommended method. For details, see: https://onion.io/2bt-cross-compiling-c-programs-part-1/

Using a Linux System

Not recommended for beginners

See the Dockerfile to get an idea of the system and environment requirements.

To correctly initialize the build system, run the following:

sh scripts/onion-feed-setup.sh
git checkout .config

This will initialize & configure all the package feeds as well as setup the .config file to match this repo. With these commands, the firmware built will match the official firmware released by Onion.

LEDE Linux Distribution

This is the buildsystem for the LEDE Linux distribution.

Please use "make menuconfig" to choose your preferred configuration for the toolchain and firmware.

You need to have installed gcc, binutils, bzip2, flex, python, perl, make, find, grep, diff, unzip, gawk, getopt, subversion, libz-dev and libc headers.

Run "./scripts/feeds update -a" to get all the latest package definitions defined in feeds.conf / feeds.conf.default respectively and "./scripts/feeds install -a" to install symlinks of all of them into package/feeds/.

Use "make menuconfig" to configure your image.

Simply running "make" will build your firmware. It will download all sources, build the cross-compile toolchain, the kernel and all choosen applications.

To build your own firmware you need to have access to a Linux, BSD or MacOSX system (case-sensitive filesystem required). Cygwin will not be supported because of the lack of case sensitiveness in the file system.

Sunshine! Your LEDE Community http://www.lede-project.org