Skip to content

Latest commit

 

History

History
89 lines (69 loc) · 3.58 KB

TOOLCHAIN-INSTALLATION.md

File metadata and controls

89 lines (69 loc) · 3.58 KB
Raw

PIXELIX

PIXELIX

License

Toolchain Installation

Purpose

The PlatformIO IDE is used for the development. Its a new generation toolset for embedded C/C++ development, integrated as extension in Microsoft Visual Studio Code Editor.

Installation Of VSCode

  1. Install VSCode which depends on your operating system.
  2. Install PlatformIO IDE according to this HowTo.
  3. Close and start VSCode again.
  4. Recommended is to take a look to the quick-start guide.

Installation Of git

Linux (Debian, Ubuntu)

$ sudo apt update

$ sudo apt install git

Windows

If you like to hack on the console/command shell, just git for windows is necessary to install. Alternative with a graphical user interface install TortoiseGIT, which includes git for windows.

Installation Of Test Environment

The test environment is only necessary if you want to modify the sourcecode and test it afterwards. :raising_hand: If your only interesting in getting PIXELIX running on your target, skip this installation.

Linux (Debian, Ubuntu)

$ sudo apt update

$ sudo apt install build-essential

$ sudo apt-get install manpages-dev

Windows

  1. For the test environment on windows platform, install Mingw-w64 by using the online installer and following installation settings:
    • Version: Choose the newest
    • Architecture: x86_64
    • Threads: posix
    • Exception: seh
    • Build revision: 0
  2. Add Mingw binary folder (C:\Program Files\mingw-w64\<depends-on-your-installation-settings>\mingw64\bin)to path, see environment variables.

Next Step

The necessary tools are now installed and ready to use. The next step is to get the sourcecode and all related files and build the firmware and filesystem image.

Issues, Ideas And Bugs

If you have further ideas or you found some bugs, great! Create a issue or if you are able and willing to fix it by yourself, clone the repository and create a pull request.

License

The whole source code is published under the MIT license. Consider the different licenses of the used third party libraries too!

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.