Welcome to NetBurner Version 3! This documentation package details the capabilities of your NetBurner Development Software and Tools. Please refer to the overview described below. The recommended starting points at the bottom of this page will help you get your system up and running quickly.
There is also a pdf version of this document: PDF Version
For the latest version of this manual please visit the Docs and Support section at www.netburner.com
The NBEclipse Getting Started Guide
Describes how to create projects and build applications.
Migration Guides
Migration guides for those moving from tools revision 2.x.
The NetBurner Application Programming Interface (API)
Description of the classes, structures and function calls provided in the NetBurner libraries.
Example Programs
Examples demonstrating the use of the hardware and software. Source code is located in "\nburn\examples"
Programmers Guides
Programmers Guides detail how to use various system capabilities
- Device configuration and the Configuration Server
- HTML Processing and Web Server
- NetBurner Real-Time Operating System (NBRTOS)
- Network Protocols such as TCP and UDP
- Security using SSL/TLS
- Embedded Flash File System (EFFS)
Platform References
The Platform References of this guide provide hardware information such as memory maps and device recovery should your application crash in a way that is not easily reset. Schematics for your NetBurner devices are located in the \nburn\docs\NetBurner\platform
folder.
Utilities
Tools and Utilities that are run on a client computer, such as discover, configuration, and application updates.
Production and Deployment
Utilities that you can use in your production environment to program and configure modules in volume
Recommended Starting Point for New Developers
- Configure the development kit hardware as described in the Quick Start Guide.
- Connect both your development computer and your NetBurner device to a network with Internet access. Internet access is not required for development, but will make initial the configuration of the device easier.
- Connect the USB interface from the development board to your computer. It will provide both power and a console/debug serial port. To view status and debug information, run a serial terminal program such as the included MTTTY for Windows.
- Your NetBurner device should be running a pre-programmed factory application. Open a web browser and type "discover.netburner.com" to identify your device. Links on the web page are available to go directly to the device's web page, and it's configuration page. Note: if you are unable to see your device, but know it's IP address, you can type the IP address into your browser manually. You can also try the Windows IPSetup utility to identify an IP address.
- Refer to the NBEclipse Getting Started Guide section of this document to learn how to create, build and download applications.
- Create a new project for the Factory Application example for your platform. The example will be located in the "\nburn\examples\PlatformSpecific" directory. You should be able to easily modify and experiment with the example code.
- Refer to the Programmers Guide and NetBurner API documents for additional information.
Additional Suggested Starting Examples
Over 100 examples are located in the \nburn\examples
folder:
- ShowInterfaces: Displays all available network interface information on a web page and serial port
- SimpleHtml: Minimal web server
- IPADDR-IP Address: IPADDR object operations for assignment and display
- PlatformSpecific: Unique peripherals for each hardware platform, such as timers, ADC, DAC and unique I2C and SPI peripherals
- RTOS: How to use the various system RTOS capabilities
Location of Original Factory Program
If at any time you wish to restore the original factory program that was running on your device, the pre-built application image is located in the \nburn\platform\<your platform>\original
folder. For example, \nburn\platform\MODM7AE70\original
. This path assumes a default install to a folder named nburn
.
Experienced NetBurner Customers
A significant change you will notice is how the device configuration is accomplished using a web interface. Please refer to the Migration Guide for a detailed description of the differences between release version 3 and previous releases.
Useful Topics:
Device Discovery and Configuration
NBEclipse
Command Line Tools
Migration Guides
Programmers Guide
Example Applications
Platform References
System Diagnostics
PC Tools and Utilities
Production & Deployment