gadgetos

Please be advised that GadgetOS will eventually replace Gadget-buildroot, however the software and documentation for GadgetOS are under very active, daily development. This is a work in progress release of the source code.

Install required build tools

Install sunxi-fel and fastboot

Clients for bootloaders on gr8. These support USB flashing.

linux (debian):

```

TODO: fastboot install instructions

sudo apt-get update sudo apt-get install android-tools-fastboot

get sunxi-fel

sudo apt-get update sudo apt-get install libusb-1.0-0-dev pkg-config git clone https://github.com/linux-sunxi/sunxi-tools.git pushd sunxi-tools make make install popd ```

macOS:

```

get fastboot

brew tap caskroom/cask brew cask install android-platform-tools

install libusb

brew install libusb

get sunxi-fel

git clone https://github.com/linux-sunxi/sunxi-tools.git pushd sunxi-tools make make install popd ```

Install docker: Provides containers to run your gadgetos builds

linux (Ubuntu):

https://docs.docker.com/engine/installation/linux/ubuntulinux/

linux (debian):

https://docs.docker.com/engine/installation/linux/debian/

macOS:

https://docs.docker.com/docker-for-mac/

Build and flash gadgetos

Get gadgetos source code

git clone https://github.com/NextThingCo/Gadget-OS.git cd Gadget-OS

Create docker image for building gadgetos

scripts/init-container

On macOS, you'll need to launch the Docker application from your Applications folder before you can run these scripts. This can take about 10-15 minutes, depending on your computer.

Create gadgetos config file

make chippro_defconfig

Creating this config file takes less than a minute.

[optional] Customize your configuration

If you want to add some capabilities to the default rootfs, you can use an ncurses UI to navigate the many options of buildroot: make nconfig

[optional] Customize your kernel

If you want to add some capabilities to the kernel, you can use an ncurses UI to navigate the many options: make linux-nconfig

Make gadgetos

Now you are ready to build!

make

This can take an hour or more.

Flash With OS

Now that you have built an operating system, you can flash it to CHIP Pro.

Flash gadgetos image to chippro

Hold down the fel button and power up the Dev Board and scripts/flash-gadget The image will flash to the CHIP Pro. Once flashing has finished, reboot your device. You can then connect via UART and start using it.