Quick start: Difference between revisions

From Miosix Wiki
Jump to navigation Jump to search
Better instructions for configuring VSCode.
No edit summary
Line 8: Line 8:
* [[Windows Quick Start|Getting Started on Windows]]
* [[Windows Quick Start|Getting Started on Windows]]
* [[MacOS Quick Start|Getting Started on macOS]]
* [[MacOS Quick Start|Getting Started on macOS]]
= Miosix and git workflow =
See [[Miosix and git workflow]] to understand how to manage the Miosix git repository.


= In-circuit debugger =
= In-circuit debugger =
Line 19: Line 15:
* [[Linux Debugger configuration]]
* [[Linux Debugger configuration]]
* [[Windows Debugger configuration]]
* [[Windows Debugger configuration]]
= IDEs =
At the moment the simplest way to develop Miosix is to use a plain text editor. Alternatively, you can use any IDE that supports Makefiles to take advantage of features such as autocompletion and/or debugger integration (where available).
== Visual Studio Code ==
Visual Studio Code is known to work properly on the Miosix source tree with the standard C/C++ and Makefile extensions. After installing these extensions, you need to configure IntelliSense in the C/C++ extension to use the include paths found from the Makefile by setting the ''Configuration provider'' for the workspace to <code>ms-vscode.makefile-tools</code>.
Integration with GDB/openocd has not been tested but you can run GDB/openocd manually in the integrated terminal.
== Netbeans IDE ==
'''Important:''' These instructions were developed back when NetBeans was still a Sun product, they are probably outdated by now!
For a long time the default IDE to develop for Miosix has been [https://netbeans.org/ Netbeans]. NetBeans does not come with Miosix support out of the box, so you have to configure it first.
* [[Linux Netbeans configuration]]
* [[Windows Netbeans configuration]]
* [[OSX Netbeans configuration]]
== Other IDEs ==
* [[VisualStudio Quick Start|Windows Visual Studio configuration]] using VisualGDB which integrates in-circuit debugging support.
* [[Linux Eclipse configuration|Eclipse]], which has the added feature to allow in-circuit debugging directly from the IDE.
* [[Linux QtCreator configuration]]
* [[Windows QtCreator configuration]]
[[Category:Installation and Configuration]]

Revision as of 14:27, 9 May 2026

To start using Miosix you need a patched version of the GCC compiler called Miosix Toolchain and git to download the kernel sources. Optionally you can also use an IDE to simplify code development, and an in-circuit debugger to speed up bug fixing.

Getting started

This section will guide you through the installation of the minimum requirements to start using Miosix: installing the compiler, and downloading the kernel.

In-circuit debugger

An in-circuit debugger allows to physically halt the CPU inside a microcontroller, single-step it and view all the variables at any given time. It is a powerful tool to debug software running on a microcontroller. Miosix uses GDB and openocd for in-circuit debugging.