NetBurner 3.0
Creating Projects and Importing Files

This is the most common type of project creation. It will be used to build and run example programs, and is a good starting point for your own projects. By "empty project" we are referring to creating a project without running the Application Wizard to auto-generate a minimal application. After we create the project we will use the project import feature to import source code files from an example into the project.

  1. Create an empty project.
  2. Import source files by right-clicking on the project name and using the Import feature from the drop down menu.
  3. Build the application and download to your NetBurner device.

Create a New Project

From the main menu, select File->New->Project:

CreateNewProject.jpg
Create a New Project


Select the NetBurner Project Type

Select the NetBurner project type, then select Next:

SelectNetburnerProject.jpg
Select NetBurner Project Type


Specify Project Name and Executable Option

Enter your project name in the Project Name field (it is best not to use spaces with gcc tool chains). In this example we entered "SimplHtml" since that is the example we will import. Make sure the Executable is set to: "NetBurner C++ Project".

IMPORTANT : Be sure to select NetBurner Device Executable
Note: You can create a project in a directory outside of your workspace by unchecking the Use Default Location checkbox, and using the Browse button to select the directory containing the source files.

NetBurnerDeviceExe.jpg
Select NetBurner Device Executable


Project Configurations

The default options for the project configurations are both Release and Debug. Leave the defaults and select Next.

ProjectConfigurations.jpg
Project Configurations


Select Your NetBurner Target Device

There are two ways to select your target NetBurner device:

  1. Click on the Search button to bring up a list of NetBurner devices on your network (device must be operational).
  2. Manually: Click on the Target Platform drop down box to select your platform, then type in the IP address.
    EclipseDeviceSearch.jpg
    Search for devices

When using the Search feature, select the device in the list that corresponds to the MAC address printed on the label of your NetBurner device. In the image below we can see the device type, MODM7AE70, it's MAC address, and it's IP address. When done select Next:

EclipseSelectDevice.jpg
Select Your Device


It will then fill in the platform and IP address for you:

EclipsePlatOptComplete.jpg
Successful search entry


Application Wizard

Since we are creating an empty project and will be importing our own source files we do not want to select any items here. However, if you wish to generate a minimal application using the Application Wizard, select both Standard Initialization and Web Server. This will generate a main.cpp source file to use as a starting point for your application. Select Finish to complete the project creation.

EclipseAppWizard.jpg
Skip Application Wizard code generation


New Project Created

You will now see your new project in the Project Explorer pane. At this point we have a project, but still need to import our source files (if you did not use the Application Wizard).

EclipseEmptyProjectComplete.jpg
A new project has been created


Import Example Source Files to the Project SRC Folder

The next step is to import the source files of an example. NBEclipse uses a make utility to manage projects, and will attempt to build all source files in your project directory. Do not import non-source code files, such as .o, .elf, .map, .mk, auto-generated htmldata.cpp files, etc. NBEclipse will store all output files similar to these in project subdirectories named "Release" and "Debug" corresponding to the build type preformed.

For this demonstration we will use "\nburn\examples\Web\SimpleHtml". The first step is to right-click on your project in the NBEclipse Project Explorer pane:

EclipseSelectImport.jpg
Select Import


Next select the General->File System, then select Next:

EclipseSelectFileSystem.jpg
Select File System


Select the Browse button to bring up a file selection window, navigate to "\nburn\examples\Web\SimpleHtml", and select the OK button

EclipseSelectSimpleHtml.jpg
Select the Simple HTML Example


Once back at the File System dialog box, click on the ">" symbol next the the SimpleHtml name to open the tree structure. You can see that there is a folder named src and a folder named html. We want the files in both folders, so select the checkbox next to the name "SimpleHtml", which will select all folders underneath it. Note: the makefile you see is only used for command line builds, but it does no harm to import it as well.

EclipseSelectSimpleHtmlCheckbox.jpg
Select all SimpleHtml files for import


Select Finish, which will import the files and automatically build the project. You can view the status of the build process in the console window, located in the lower right corner of your screen. In the Project Explorer, click on the ">" symbol next to SimpleHtml. Some important items of note:

  • Build Targets has two functions: downloading code to your device, and rebuilding the system libraries if needed.
  • The src folder contains all your source code files, such as main.cpp.
  • The html folder contains all your web based code.
  • The overload directory is used to override any system library files
    EclipseImportComplete.jpg
    Import complete

Clicking on the ">" symbol next to the src folder, you can open main.cpp in the editor

EclipseOpenMain.jpg
Open main.cpp


At this point you have a project complete with source code files. You can use the editor to modify both src and html files. If you wish to open a html file in text mode to do things like add dynamic content tags such as CPPCALL, VARIABLE, etc, right-click on the html file and use the Open With option to select the text editor:

EclipseHtmlText.jpg
Open HTML files in text mode


By default, any time you modify and save a source file, the system will automatically build the application. If you prefer to turn off the auto-build option, to build the project: from the main menu select Project->Build Project, or use the <cntl>b keyboard shortcut.

EclipseBuildProject.jpg
Build the Project


Now that an application image has been built, the next step is to download the binary image to your NetBurner device. NBEclipse can simultaneously handle multiple NetBurner hardware platforms of the same or different types. For example, multiple MODM7AE70 core modules, or a mix with with some MOD54415 modules. Targeting a project to a specific hardware device, is accomplished by creating a Run Configuration for release mode project builds, or a Debug Configuration for project debug builds. An important part of such a configuration is associating the device's IP address with the project so NBEclipse knows where to download the project's binary image.

When you create a new project and select the download option for the first time, NBEclipse will create a Run Configuration for you (Run and Debug Configurations can also be created manually). First select your project by left clicking on it in the Project Window:

EclipseSelectProject.jpg
Select Project


Then click on the Run button in the upper right corner of NBEclipse:

EclipseSelectRunButton.jpg
Select Run Button


The Run As dialog box will appear. Select NetBurner Application, which will run the application on the remote system: When you click the OK button, NBEclipse will download the binary image to the remote device and reboot it.

EclipseSelectRunApplication.jpg
Select Run Application


The application should now running on the device. If you do not remember the IP address of the device, you can find it using the "Find" window in the lower left of NBEclipse. In the screen shot below there are 3 devices. The device running SimpleHtml has IP address 10.1.1.196.

EclipseFindDeviceIP.jpg
Find Device IP


Opening a web browser and typing 10.1.1.196 in the URL field:

EclipseHtmlPage.jpg
HTML Page


If you now look at the upper left side of NBEclipse, you will see the configuration set to Run, and the project set to SimpleHtml for the configuration.

EclipseConfigurationSelections.jpg
Run Configuration


All NetBurner examples make use of the debug/console serial port to provide status messages. You will need to have a serial connection to your device either through USB or the DB9 on the development board, depending on your hardware configuration. You can then use the MTTTY serial terminal application to view the serial output. To open MTTTY:

EclipseOpenMttty.jpg
Open MTTTY


When the device boots the SimpleHtml application you will see:

EclipseMtttyOutput.jpg
MTTTY Output