NetBurner Quick Start Guides
Running the Factory Application

Plug in the Module

After installating the NNDK software, it's a good idea to plug in your module and connect to it to verify that the network and USB driver are properly configured.

To proceed, carefully insert the NetBurner module in to the non powered development board that is included with your kit. All network modules plug in to the board with the Ethernet jack facing the outside edge of the carrier board. If applicable, plug in an Ethernet cable in to the module.

Note
A crossover cable is not required in any network configuration. The network PHY includes Auto MDI/MDIX, which will automatically adjust to make link over both crossover and straight-through cable types.

For more information on how to configure the carrier board to power the module through the barrel jack or the USB jack, please see the section of the manual on the MOD-DEV-70 Carrier Board, earlier in this guide.

Factory Application Overview

The factory application that is included with the NetBurner module includes a simple web page, network configuration options and a demo of some of the hardware available on the device.

Find your Device

To begin, you need to find out the IP address of your module. There are several ways to do this. The recommended option is to locate your device using our online discovery service. You can do this by opening a browser and navigating to https://discover.netburner.com. This webpage should load a table that shows devices on your local area network which are running applications built with NNDK 3.x. From this table, you can access the web interface served from the device by clicking on the link in the "Web Page" column. To access a device's configuration record, click on the link in the "Config" column..

If you don't have internet access from your location, you can run our utility, Local Discovery. This program sends out a request to all NetBurner devices on the local network. It opens a browser page on the first device to respond that lists all of the discovered devices, or a page that shows that no devices were found.

Another option to find the IP address of your device is to use the NBEclipse IDE. As before, ensure that your device is powered on and plugged into the same network as your PC. Open NBEclipse, and in the bottom left of the workspace, NBFind can be found running. NBFind lists the IP, application, and MAC address of all NetBurner devices on your local network.

A final option is to use the included utility IPSetup. If the device is powered on and plugged into the same network as your PC, run IPSetup. This application shows all NetBurner devices on your network. Be aware that as of NNDK 3.x, IPSetup can not be used to configure your device. Our configuration system now handles this, as described later in this guide.

Note: If these options are failing, there may be a firewall issue blocking the applications from sending the UDP broadcast that is used to locate NetBurner devices. Always grant NetBurner applications the ability to get through your OS firewall and ensure that UDP port 20034 is open for use.

View the Web Page

The factory application runs a web server with a basic web page detailing some of the features of the device and development board. Once you have found your device's IP address, open your favorite browser and point it at the IP address of the device.

View the Config Page

NetBurner devices are now configured through the use of the configuration page. You can access this page via a web browser. To do so, open a web browser and navigate to the IP address of your device on port 20034. This URL request should look like the following:

http://<Device IP>:20034

Where <Device IP> is replaced with the corresponding IP address. The configuration page allows you to view and modify all of the device's boot and network settings. Additionally, you can use this page to download a new application to the device. For more on the configuration system, please refer to the "Config Server Programming Guide" section of the "Programmers Guide".

Develop your own Application

Now that the NetBurner tools are installed, the hardware is set up and you have verified this by accessing the device's web server. You have now graduated beyond this quick start guide.

To begin writing an application, we recommend reading through the NBEclipse Getting Started guide and the NetBurner Programmers Guide. In the NBEclipse guide, you will find information on writing NetBurner applications, sending new applications to the module and debugging with the graphical debugger. The Programmers guide will teach you more about the NetBurner libraries, operating system, and writing of applications in a multitask environment. Both of these documents can be found in the \nburn\docs\NetBurner folder of your NNDK software installation by opening the file NetBurner-Documentation.html.

NetBurner Examples

The NNDK includes a multitude of examples that demonstrate the various hardware and software applications of the kit. These examples can be found in your NNDK installation directory, under the examples folder. The default location is \nburn\examples.