Everything needed to develop software for C.H.I.P.
While it is possible to install the SDK natively on your computer, currently the only supported way is to run it from a virtual machine.
A version of Windows, Mac OS X or your favourite Linux distribution running VirtualBox and Vagrant. For the virtual machine at least of free 1 GB RAM are necessary. Up to 40 GB of disk space may be used.
- Install VirtualBox
- Install VirtualBox Extension Pack for the host - this is necessary to flash C.H.I.P from inside the virtual machine.
- Operating system specific stuff:
- If you are on Windows, you need to add the VirtualBox installation directory to your PATH.
- In case of a Ubuntu host: add your user to the vboxusers group!
- Install Git
- Git clone https://github.com/NextThingCo/CHIP-SDK
In a shell on the host type to following to start up the virtual machine:
cd CHIP-SDK/vagrant
vagrant up
In a shell on the host type to following:
cd CHIP-SDK/vagrant
vagrant ssh
In a shell on the host type:
vagrant halt
In case you run into trouble because the kernel in the VM was updated and the shared vagrant folder can no longer be mounted, update the guest additions by typing the following in the chip_sdk/vagrant directory on the host:
vagrant plugin install vagrant-vbguest
Also look at this blog post
In a shell on the host log into the virtual machine by typing:
vagrant ssh
Logged in to the virtual machine type:
/vagrant/install.sh
Login to the virtual machine:
vagrant ssh
cd $HOME/chip_sdk/tools
sudo BUILDROOT_OUTPUT_DIR=../buildroot/output ./chip-fel-flash.sh erase-bb
Plese note the 'erase-bb' option which causes the bad block table of the NAND to be erased. This is not necessary for C.H.I.Ps that have already been flashed.