Getting started¶
Downloading theCore¶
First thing first you need to download theCore and setup development environment. To do that, use dedicated tcore script, written in Python 3:
Install Python 3 and dependencies, by using DigitalOcean guide.
Install
tcore
script:sudo pip3 install tcore
Install
curl
. For example, in Ubuntu, run:sudo apt-get install curl
Download theCore and development environment. Choose one option from below:
With script asking root permissions (see Details of the development environment section to understand why):
tcore bootstrap
With script not asking any root permissions:
sudo mkdir /nix sudo chown $(whoami) /nix tcore bootstrap
Details of the development environment¶
All additional packages, like toolchains, build dependencies and some additional host utilities are manager trough Nix. Nix helps to deploy everything that you need during development of the embedded application.
The installiation process of Nix is curated by the tcore
script.
More information about it you can find in the tcore script section.
Nix is installed under /nix directory. If it does not exist, Nix installation script will ask for permissions. That’s why running bare tcore bootstrap may result in a sudo password request.
Some examples of packages, contaned in /nix
directory are:
- Git
- CMake
- toolchains: GCC, Clang
- OpenOCD
- GDB
Check the default.nix
file in the root of theCore project for full list
of packages requested from Nix.
After Nix is deployed, theCore itself is downloaded into ~/.theCore
directory.
tcore
script uses Git under Nix environment to retrieve theCore from a remote,
so no need to install Git into the host machine.
Moving forward¶
From now on, you are ready for creating embedded applications using theCore. Check Examples section to understand how such applications are built.
More info about Nix¶
If you want to get yourself more familiar with Nix, check out the Domenkozar’s blog or read the official documentation.