Linux Netbeans configuration - Revision history

Fede.tft at 11:28, 22 April 2014

2014-04-22T11:28:35Z

← Older revision		Revision as of 11:28, 22 April 2014
Line 82:		Line 82:
	Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.		Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.
	There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tool as explained in [[Linux Quick Start]].		There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tool as explained in [[Linux Quick Start]].

			[[Category:Installation and Configuration]]

Fede.tft at 11:20, 22 April 2014

2014-04-22T11:20:28Z

← Older revision		Revision as of 11:20, 22 April 2014
Line 76:		Line 76:
	However, please note that you can edit Makefile.inc and [[miosix_settingls.h\|miosix/config/miosix_settings.h]] as regular source files within the IDE, without the need to use a standalone text editor.		However, please note that you can edit Makefile.inc and [[miosix_settingls.h\|miosix/config/miosix_settings.h]] as regular source files within the IDE, without the need to use a standalone text editor.

	You can open main.cpp (double click on it from the left pane), ~~ant~~ start typing your code. Code completion is invoked by typing the first letters of the function, variable, class or member function and hitting "Ctrl-space". Netbeans also integrates with Doxygen documentation, so you can see the documentation for Miosix classes and functions directly from the IDE.		You can open main.cpp (double click on it from the left pane), and start typing your code. Code completion is invoked by typing the first letters of the function, variable, class or member function and hitting "Ctrl-space". Netbeans also integrates with Doxygen documentation, so you can see the documentation for Miosix classes and functions directly from the IDE.

	[[File:Nbsetup6-linux.png]]		[[File:Nbsetup6-linux.png]]

	Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.		Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.
	There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 ~~tools~~ as explained in [[Linux Quick Start]].		There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tool as explained in [[Linux Quick Start]].

Fede.tft at 11:18, 22 April 2014

2014-04-22T11:18:26Z

← Older revision		Revision as of 11:18, 22 April 2014
Line 65:		Line 65:
	[[File:Nbsetup4-linux.png]]		[[File:Nbsetup4-linux.png]]

	You may want to rename the project from the default "miosix_np_2" to the name of the project you are going to develop, by right clicking on the project name and selecting "Rename".		You may want to rename the project from the default "miosix_np_2" to the name of the project you are going to develop, by right clicking on the project name and selecting "Rename", once you have opened it.

	Miosix supports different boards, each of which has different board support packages and peripheral drivers. To get code completion support for your board you need to select it within the IDE, as in the following image		Miosix supports different boards, each of which has different board support packages and peripheral drivers. To get code completion support for your board you need to select it within the IDE, as in the following image

Fede.tft at 11:14, 22 April 2014

2014-04-22T11:14:09Z

← Older revision		Revision as of 11:14, 22 April 2014
Line 20:		Line 20:

	If you use Gnome the IDE will use the right theme out of the box, but if you use a different desktop environment, like KDE there is a trick to get the nice theme, which consists in editing the .desktop file for Netbeans, which by default is in ''/usr/share/applications/netbeans-8.0.desktop'' (if you have installed a version of the IDE different from 8.0, the name will change likewise) and change the ''Exec='' line from		If you use Gnome the IDE will use the right theme out of the box, but if you use a different desktop environment, like KDE there is a trick to get the nice theme, which consists in editing the .desktop file for Netbeans, which by default is in ''/usr/share/applications/netbeans-8.0.desktop'' (if you have installed a version of the IDE different from 8.0, the name will change likewise) and change the ''Exec='' line from


	<source lang="bash">		<source lang="bash">

Fede.tft at 11:08, 22 April 2014

2014-04-22T11:08:57Z

Fede.tft: Created page with "=== Installing the IDE === Netbeans is an IDE written in Java, and the Java virtual machine is needed to use the IDE. By default most Linux distributions do not come with a j..."

2014-04-22T10:10:55Z

Created page with "=== Installing the IDE === Netbeans is an IDE written in Java, and the Java virtual machine is needed to use the IDE. By default most Linux distributions do not come with a j..."

New page

=== Installing the IDE ===

Netbeans is an IDE written in Java, and the Java virtual machine is needed to use the IDE. By default most Linux distributions do not come with a jvm pre-installed, so you need to install one.

<source lang="bash">
sudo apt-get install openjdk-7-jre # Install Java for Ubuntu/Debian
</source>

After that, you can install the Netbeans IDE. In theory, you could install it via apt-get, but in that way you will get the version of the IDE to write Java programs, not C/C++ programs. Even though you can install C/C++ support later, you will end up with an installation that requires far more disk space (up to several hundred megabytes). It is therefore best to download the IDE from the [https://netbeans.org/downloads Netbeans website] and install it manually. The download page will show many options depending on the programming language you are interested in. Among the possible versions choose the C/C++ version, because these are the languages used by Miosix.

The downloaded file has a .sh extension, and a name like ''netbeans-8.0-cpp-linux.sh''. You can install it by opening a terminal and typing

<source lang="bash">
sudo sh netbeans-8.0-cpp-linux.sh
</source>

a wizard will guide you through the installation.

== Theme configuration ==

If you use Gnome the IDE will use the right theme out of the box, but if you use a different desktop environment, like KDE there is a trick to get the nice theme, which consists in editing the .desktop file for Netbeans, which by default is in ''/usr/share/applications/netbeans-8.0.desktop'' (if you have installed a version of the IDE different from 8.0, the name will change likewise) and change the ''Exec='' line from

<source lang="bash">
Exec=/bin/sh "/usr/local/netbeans-8.0/bin/netbeans"
</source>

to the following value which will force the IDE to use the nice Linux theme

<source lang="bash">
Exec=/usr/local/netbeans-8.0/bin/netbeans --laf com.sun.java.swing.plaf.gtk.GTKLookAndFeel
</source>

To edit the configuration file, which is writable only by root, you can use ''nano'' or ''vi'' from a shell.

<source lang="bash">
sudo nano /usr/share/applications/netbeans-8.0.desktop
</source>

=== Configuring the IDE ===

Netbeans is a generic C/C++ IDE, and once installed is not set up by default to develop for ARM microcontrollers and Miosix. So you need to configure it. This is a one-time step that you will have to do again only if you re-install the IDE.

Note: this assumes you have already installed the Miosix toolchain, if not read the [[Windows Quick Start]] tutorial first.

Open the Netbeans IDE (there should be an icon on the Desktop after installation) and click on "Tools > Options". From the top of the options window select the C/C++ panel, and click the "Add" button to add a compiler to Netbeans. As "Base directory" choose "C:\arm-miosix-eabi\arm-miosix-eabi\bin". Choose "GNU MinGW" as "Tool collection family", and "ARM_MIOSIX_EABI" as "Tool collection name".
Note that you '''must''' use the "ARM_MIOSIX_EABI" name, or you'll have problems later.
The C and C++ compiler should be automatically filled in by Netbeans, if not copy them from the screenshot below. Please note that make.exe should have '''no path''' otherwise compiling will fail.

[[File:Nbsetup1-windows.png]]

Last, you will need to set up the paths with the compiler libraries for code completion to work. Click on the "Code assistance" tab, and "C compiler" sub-tab. The list of folders and macro definitions should look like in this screenshot, if not, add the paths manually.

[[File:Nbsetup2-windows.png]]

Then click th "C++ compiler" sub-tab and check if the paths and macro definitions are correct. If not add the missing paths manually as in the next screenshot.

[[File:Nbsetup3-windows.png]]

Configuration is now complete. You can close the Options windows by clicking "Ok".

=== Building the Miosix kernel with Netbeans ===

Select "File > Open project" and select the "miosix_np_2" directory withn the Miosix top level directory.

[[File:Nbsetup4-windows.png]]

You may want to rename the project from the default "miosix_np_2" to the name of the project you are going to develop, by right clicking on the project name and selecting "Rename".

Miosix supports different boards, each of which has different board support packages and peripheral drivers. To get code completion support for your board you need to select it within the IDE, as in the following image

[[File:Nbsetup5-windows.png]]

Please note that in the [[Windows Quick Start]] you had to select the board to compile for by editing the [[Makefile.inc|miosix/config/Makefile.inc]]. The board selection within the IDE '''does not replace''' the need to edit Makefile.inc, they serve two different purposes:
* Board selection within the IDE is used by the IDE to set up code completion for your board
* Board selection in Makefile.inc tells the kernel for which board it needs to be compiled.
However, please note that you can edit Makefile.inc and [[miosix_settingls.h|miosix/config/miosix_settings.h]] as regular source files within the IDE, without the need to use Notepad++.

You can open main.cpp (double click on it from the left pane), ant start typing your code. Code completion is invoked by typing the first letters of the function, variable, class or member function and hitting "Ctrl-space". Netbeans also integrates with Doxygen documentation, so you can see the documentation for Miosix classes and functions directly from the IDE.

[[File:Nbsetup6-windows.png]]

Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.
There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tools as explained in [[Windows Quick Start]].

← Older revision		Revision as of 11:08, 22 April 2014
Line 42:		Line 42:
	Netbeans is a generic C/C++ IDE, and once installed is not set up by default to develop for ARM microcontrollers and Miosix. So you need to configure it. This is a one-time step that you will have to do again only if you re-install the IDE.		Netbeans is a generic C/C++ IDE, and once installed is not set up by default to develop for ARM microcontrollers and Miosix. So you need to configure it. This is a one-time step that you will have to do again only if you re-install the IDE.

	Note: this assumes you have already installed the Miosix toolchain, if not read the [[~~Windows~~ Quick Start]] tutorial first.		Note: this assumes you have already installed the Miosix toolchain, if not read the [[Linux Quick Start]] tutorial first.

	Open the Netbeans IDE ~~(there should be an icon on the Desktop after installation)~~ and click on "Tools > Options". From the top of the options window select the C/C++ panel, and click the "Add" button to add a compiler to Netbeans. As "Base directory" choose "~~C:\~~arm-miosix-eabi\arm-miosix-eabi\bin". Choose "GNU ~~MinGW~~" as "Tool collection family", and "ARM_MIOSIX_EABI" as "Tool collection name".		Open the Netbeans IDE and click on "Tools > Options". From the top of the options window select the C/C++ panel, and click the "Add" button to add a compiler to Netbeans. As "Base directory" choose "/opt/arm-miosix-eabi/arm-miosix-eabi/bin". Choose "GNU" as "Tool collection family", and "ARM_MIOSIX_EABI" as "Tool collection name".
	Note that you '''must''' use the "ARM_MIOSIX_EABI" name, or you'll have problems later.		Note that you '''must''' use the "ARM_MIOSIX_EABI" name, or you'll have problems later.
	The C and C++ compiler should be automatically filled in by Netbeans, if not copy them from the screenshot below~~. Please note that make.exe should have '''no path''' otherwise compiling will fail~~.		The C and C++ compiler should be automatically filled in by Netbeans, if not copy them from the screenshot below.

	[[File:Nbsetup1-~~windows~~.png]]		[[File:Nbsetup1-linux.png]]

	Last, you will need to set up the paths with the compiler libraries for code completion to work. Click on the "Code assistance" tab, and "C compiler" sub-tab. The list of folders and macro definitions should look like in this screenshot, if not, add the paths manually.		Last, you will need to set up the paths with the compiler libraries for code completion to work. Click on the "Code assistance" tab, and "C compiler" sub-tab. The list of folders and macro definitions should look like in this screenshot, if not, add the paths manually.

	[[File:Nbsetup2-~~windows~~.png]]		[[File:Nbsetup2-linux.png]]

	Then click th "C++ compiler" sub-tab and check if the paths and macro definitions are correct. If not add the missing paths manually as in the next screenshot.		Then click th "C++ compiler" sub-tab and check if the paths and macro definitions are correct. If not add the missing paths manually as in the next screenshot.

	[[File:Nbsetup3-~~windows~~.png]]		[[File:Nbsetup3-linux.png]]

	Configuration is now complete. You can close the Options windows by clicking "Ok".		Configuration is now complete. You can close the Options windows by clicking "Ok".
Line 64:		Line 64:
	Select "File > Open project" and select the "miosix_np_2" directory withn the Miosix top level directory.		Select "File > Open project" and select the "miosix_np_2" directory withn the Miosix top level directory.

	[[File:Nbsetup4-~~windows~~.png]]		[[File:Nbsetup4-linux.png]]

	You may want to rename the project from the default "miosix_np_2" to the name of the project you are going to develop, by right clicking on the project name and selecting "Rename".		You may want to rename the project from the default "miosix_np_2" to the name of the project you are going to develop, by right clicking on the project name and selecting "Rename".
Line 70:		Line 70:
	Miosix supports different boards, each of which has different board support packages and peripheral drivers. To get code completion support for your board you need to select it within the IDE, as in the following image		Miosix supports different boards, each of which has different board support packages and peripheral drivers. To get code completion support for your board you need to select it within the IDE, as in the following image

	[[File:Nbsetup5-~~windows~~.png]]		[[File:Nbsetup5-linux.png]]

	Please note that in the [[~~Windows~~ Quick Start]] you had to select the board to compile for by editing the [[Makefile.inc\|miosix/config/Makefile.inc]]. The board selection within the IDE '''does not replace''' the need to edit Makefile.inc, they serve two different purposes:		Please note that in the [[Linux Quick Start]] you had to select the board to compile for by editing the [[Makefile.inc\|miosix/config/Makefile.inc]]. The board selection within the IDE '''does not replace''' the need to edit Makefile.inc, they serve two different purposes:
	* Board selection within the IDE is used by the IDE to set up code completion for your board		* Board selection within the IDE is used by the IDE to set up code completion for your board
	* Board selection in Makefile.inc tells the kernel for which board it needs to be compiled.		* Board selection in Makefile.inc tells the kernel for which board it needs to be compiled.
	However, please note that you can edit Makefile.inc and [[miosix_settingls.h\|miosix/config/miosix_settings.h]] as regular source files within the IDE, without the need to use ~~Notepad++~~.		However, please note that you can edit Makefile.inc and [[miosix_settingls.h\|miosix/config/miosix_settings.h]] as regular source files within the IDE, without the need to use a standalone text editor.

	You can open main.cpp (double click on it from the left pane), ant start typing your code. Code completion is invoked by typing the first letters of the function, variable, class or member function and hitting "Ctrl-space". Netbeans also integrates with Doxygen documentation, so you can see the documentation for Miosix classes and functions directly from the IDE.		You can open main.cpp (double click on it from the left pane), ant start typing your code. Code completion is invoked by typing the first letters of the function, variable, class or member function and hitting "Ctrl-space". Netbeans also integrates with Doxygen documentation, so you can see the documentation for Miosix classes and functions directly from the IDE.

	[[File:Nbsetup6-~~windows~~.png]]		[[File:Nbsetup6-linux.png]]

	Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.		Building is performed by clicking the hammer icon above the source code editor. The Output window will appear below the source editor showing the compilation progress and eventual compiler errors.
	There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tools as explained in [[~~Windows~~ Quick Start]].		There is no known way to transfer the compiled program on a microcontroller board directly from the IDE, for this you will have to use the QSTLink2 tools as explained in [[Linux Quick Start]].