NetBurner FAQ

  1. Software Related
    1. Where is the NNDK hardware and software documentation
    2. My device no longer works, I cannot see it in IPSETUP
    3. How do I fix traps
    4. What version of the NNDK am I using
    5. How do I generate ticks faster than 50ms
    6. How much flash is my application using?
    7. How do I use the taskscan tool
    8. How do I use the smarttrap tool
    9. What is the meaning of the error "checksum fail - no valid app"
    10. How do I recompile my system files
    11. How do I download a new application via MTTTY

  2. Hardware Related
    1. Where can I find the connected pin outs for my device
    2. Where are the module schematics
    3. Which USB to serial converter should I use
    4. Module power consumption levels

  3. Monitor Related
    1. How do I use MTTTY to disable the monitor output
    2. How can I change the wait time of my NetBurner device

  4. NBEclipse Related
    1. NBEclipse gets internal error during early startup
    2. NBEclipse is running low on memory, how do I fix this


  1. Software Related

    1. Where is the NNDK hardware and software documentation

      NetBurner provides

      • Hardware Specific Quick Start Guide (hard copy)
      • * This booklet can be found in the same box that your NNDK came in.
      • NNDK Users Manual
      • * This manual is located in the \Nburn\docs directory.
        * You can accesss this manual from Windows: Start --> Programs --> Netburner NNDK --> Documentation.
      • Hardware Specific Users Manual
      • * This manual is located in the \Nburn\docs\platform directory.
        * Motorola PDF manuals and platform specific PDF documentation are embedded in this file.
        * You can accesss this manual from Windows: Start --> Programs --> Netburner NNDK --> Platform Hardware.
      • NNDK Programmers Guide
      • * This PDF is located in the \Nburn\docs directory.
        * You can accesss this guide from Windows: Start --> Programs --> Netburner NNDK --> Documentation.
      • NBEclipse Getting Started Guide
      • * This manual is located in the \Nburn\docs\Eclipse directory.
        * You can accesss this guide from Windows: Start --> Programs --> Netburner NNDK --> Documentation.

    2. My device no longer works, I cannot see it in IPSETUP

      Not all of the NetBurner example programs have networking enabled. If you downloaded an application to your NetBurner device that does not have networking enabled, it will not be recognized by IPSetup. To determine if this is the reason why your NetBurner device no longer works:

      • Attach the supplied serial cable (or the supplied NULL Modem cable for the SB72EX) from the serial port on your NetBurner device to the serial port on your host computer.
      • Execute MTTTY. (From Windows: Start --> Programs --> Netburner NNDK --> Mttty Serial Terminal.)
      • Reset your NetBurner device
      • Type an uppercase A (i.e. A) in the MTTTY window before the time expires to get into the NetBurner monitor program.
      • At the nb> prompt in the MTTTY window type the command FLA (FLA stands for Flash Application), then press the Enter key.
      • Send the tictactoe_APP.s19 file to your NetBurner device.
      • * This can be accomplished by selecting the Transfer --> Send option from the Transfer menu, or by pressing the F5 key on your keyboard.
        * This file is located (by default) in the C:\Nburn\Platform\original directory.
      • The Boot Monitor will automatically reprogram the application area of the flash and restart your NetBurner device.

      Please refer to both the "Cook Book" section and "MTTTY" (in "The NetBurner Development Tools" section) in your NetBurner User's Manual for more information. From Windows: Start --> Programs --> Netburner NNDK --> NNDK Users Manual.


    3. How do I fix traps

      A trap indicates that your application has caused an illegal operation. The monitor responds by halting and restarting your application. A typical trap message printed over the serial port looks like this:

      Trap occured
      Vector=Access Error FMT =03 SR =2004 FS =0C
      Faulted PC = 0200013A
      D0:0000000E 00000000 000000D2 000000D3 000000D4 000000D5 000000D6 000000D7
      A0:00000000 40000204 02015FCE 02002390 02000150 000000A5 2000279C 2000277C
      Waiting 2sec to start 'A' to abort

      At this point, you will need to figure out what line of code in your application is causing this. See the SmartTrap utility for help in doing this. SmartTrap usage is discussed in the NetBurner tools manual, located in \nburn\docs\NetBurnerPcTools.


    4. What version of the NNDK am I using

      To find out what version of the NNDK tool set you are using - navigate to your Nburn directory, and open up (e.g. in notepad) the release_tag file.


    5. How do I generate ticks faster than 50ms

      You have two options when you want to change the resolution of the ticks.

      • Increase the amount of ticks per second
      • Use a timer to generate an interupt at higher rate

      Be default, a tick is 50ms in length. This is defined by the constant TICKS_PER_SECOND. The default for this constant is 20. You can safely increase this constant to 200, which will yield a tick length of 500 us.

      If this is not fast enough for your application, you may want to use a timer to generate a faster interupt.


    6. How much flash is my application using?

      The XXX_APP.s19 file is stored as ascii hex, a very inefficent way to store the file; on the actual device it is stored as binary. When you build an application, the last lines of output you will see:

      Block starts at 2000000
      Block ends at 2020d00
      Block size= 131K
      Execution starts at 2000000
      compressed 134400 bytes into 83171 bytes
      Code CheckSum= 5f3a25ce
      Struct CheckSum= df17da9d
      S records output with a base address of ffc08000
      S records output with a final address of ffc1c4fb
      About to write S7...

      The line you care about is: compressed 134400 bytes into --->83171<--- bytes

      The second number is the number that you need to worry about. In the case I've just shown, the app file was 251K, but only 83.1K were actually needed in the flash.


    7. How do I use the taskscan tool

      TaskScan is a network debugging tool that is used to view all of the tasks (and their status) in your application. Note: If you create a new application using NetBurner's Application Wizard, you must manually add the TaskScan functionality.

      To use TaskScan you must add #include in your application's main.cpp file and EnableTaskMonitor(); in user main. In addition, your NetBurner device must be recognized by IPSetup. (i.e. Your program must have networking/autoupdate enabled.)

      There are no performance hits if you include TaskScan in your application unless you call it. TaskScan can be executed from Windows: Start --> Programs --> Netburner NNDK --> TaskScan.

      When the TaskScan application is executed, a "TaskScan" window will appear. In order to use the TaskScan application, you must know the IP address of your NetBurner device, and you must select your application's .elf file. The .elf file is located in the same directory as your application.

      When you are finished, click the Scan button in the "TaskScan" window.

      • The green "Ok" icon indicates that the task is ready to run.
      • The green "running man" icon indicates that the task is currently running.
      • The red "hour glass" icon indicates that the task is waiting (for a period of time) to start.
      • The red "hand" icon indicates that the task is waiting and has not started.

      There are 64 uC/OS tasks - task 1 has the highest priority and task 63 the lowest. There are seven task priorities that are predefined in constants.h (located in the \Nburn\include directory). They are:

      #define MAIN_PRIO (50)
      #define HTTP_PRIO (45)
      #define PPP_PRIO (44)
      #define TCP_PRIO (40)
      #define IP_PRIO (39)
      #define ETHER_SEND_PRIO (38)
      #define WIFI_TASK_PRIO (37)

    8. How do I use the smarttrap tool

      SmartTrap is an optional debugging tool to help you find out (troubleshoot) where your application trapped. Please refer to your NetBurner Tools User's Manual \Nburn\docs\NetBurnerPcTools\NetBurnerTools.pdf for information about SmartTrap application.


    9. What is the meaning of the error "checksum fail - no valid app"

      When the monitor boots, the code in the monitor program does a checksum calculation on the application currently in your NetBurner device.

      • If the calculated checksum matches the value stored in flash when the application was initially programmed, it jumps to the application.
      • If the checksum fails, it generally means that your program was not completely transfered to your NetBurner device.

    10. How do I recompile my system files

      There are two ways to accomplish this:

      From NBEclipse:
      • From the NBEclipse pulldown menu, select "Rebuild System Files"

      From a DOS window:
      • Navigate to your Nburn\HW Platform\system directory
      • Type the command make clean and press the Enter key.
        Type the command make and press the Enter key.
      • Navigate to your Nburn\system directory
      • Type the command make clean and press the Enter key.
        Type the command make and press the Enter key.

    11. How do I download a new application via MTTTY

      Procedure:

      • Attach the supplied serial cable (or the supplied NULL Modem cable for the SB72EX and CB34EX) from the serial port on your NetBurner device to the serial port on your host computer.
        • If you are using either the Mod5272, the Mod5282, the Mod5234, or the Mod5270 module, the serial port is the inner serial port (J7) UART0 on your Mod-Dev100 Carrier board.
        • If you are using any of the above NetBurner modules with the NetBurner promo Carrier board or the Mod5270LC kit with the Mod-Dev70 Carrier board, the serial port is the inner serial port (J4) UART0.
        • If you are using the SB72EX (with the supplied NULL Modem cable), the serial port (default configuration) is the left serial port (Port 0). Note: You must use the NULL Modem cable to connect your SB72EX to your host computer. You cannot use a standard serial cable with your SB72EX device, it will not work.
        • If you are using the CB34EX (with the supplied NULL Modem cable), the serial port (default configuration) is the DB9 port (Port 1). Note: You must use the NULL Modem cable to connect your CB34EX to your host computer. You cannot use a standard serial cable with your CB34EX device, it will not work.
        • If you are using either the SB72, SB70, or the SB72IO board with the SB72 Adapter/Evaluation board, the serial port is the inner serial port (J2) on the Adapter/Evaluation board.
        • If you are using the CFV2-66 board, the serial port is labeled J2.
        • If you are using the CFV2-40 board, the serial port is labeled J4.
      • Execute MTTTY using any one of the five methods described above. The recommended settings are listed and explained below:
        • Port: The communication port that you connected the serial cable to on your host computer (usually COM1).
        • Baud: The host computer and the attached serial (NetBurner) device must agree on a speed or baud rate to use for the serial connection (the recommended setting for both is 115200).
        • Parity: Checks whether data has been lost or written over when transmitted between your host PC and your NetBurner device (the recommended setting is None).
        • Data Bits: The number of bits in a transmitted data package (the recommended setting is 8).
        • Stop Bits: The stop bit follows the data and parity bits in serial communication. It indicates the end of transmission (the recommended setting is 1).
      • Cycle power (i.e. remove and reapply power) to your NetBurner device. You will see a "Waiting Xsec to start 'A' to abort" message in the MTTTY window.
      • Type an uppercase A (i.e. an A) in the MTTTY window before the time expires to get into the NetBurner monitor program. You will see the NetBurner prompt (i.e. nb>) in the MTTTY window.
      • After the nb> prompt in the MTTTY window type the command FLA (FLA stands for Flash Application) and then press the Enter key on your keyboard.
      • Next, send the factory application (an _APP.s19 file) to your NetBurner board. This can be accomplished by selecting the Transfer --> Send option from the Transfer menu, or by pressing the F5 key on your keyboard.
      • A Send File window will appear. Navigate to your Nburn\Hardware Platform\original directory.
      • Select the factory application (i.e. the _APP.s19 file) from the file list and click the Open button.
      • As your download progresses, "****" characters will appear in the MTTTY window, and the progress bar on the lower left hand side of the window will move towards the right.
      • The Boot Monitor will automatically reprogram the application area of the flash and restart your NetBurner device after your download is completed.

      For additional information, please refer to Section 4.3 (Getting Started) Using MTTTY in DocumentationOverview.pdf located by default in C:\Nburn\docs. Instructions can also be found in your Hard Copy Quick Start Guide (i.e RS-232 Downloads).


  2. Hardware Related

    1. Where can I find the connected pin outs for my device

      Pinout information can be found in your platform help documentation, located in \Nburn\docs\platform. Refer to the section labeled "Signal and Connecter Information"


    2. Where are the module schematics

      All of the signals on our modules are brought out directly onto the pins from the processor, so there really isn't a need for the schematic.

      Since we provide all the source, we provide a schematic only with a license agreement to protect our IP. For additional information, please refer to the Hardware Specifications section in your Hardware User's Manual. From Windows: Start --> Programs --> Netburner NNDK --> Platform Hardware. If you have specific questions about the pins, please submit another support request, and we will answer them.


    3. Which USB to serial converter should I use

      The most reliable USB to Serial Aaapter we have found so far is Cables Unlimited USB 2.0 to DB9M Serial Adapter. Here is a link to this adapter at Tiger Direct: Cables Unlimited USB to Serial


    4. What are my module power consumption levels

      NetBurner Module Current Draw (mA) Running the Factory Demo

      Mod5234-100IR - 210 no network , 310-with network
      Mod5270-100CR - 170 no network , 250-with network
      Mod5272-100CR - 320 no network , 400-with network
      Mod5282-100IR - 220 no network , 330-with network
      Mod5282-100CR - 210 no network , 300-with network

  3. Monitor Related

    1. How do I use MTTTY to disable the monitor output

      Connect your host computer to your NetBurner device using MTTTY (From Windows: Start --> Programs --> Netburner NNDK --> Mttty Serial Terminal) and boot to the monitor. You will see the nb> prompt.

      Go into the Setup menu (type the word setup at the nb> prompt and press the Enter key), and turn on quiet boot (option Q). This will disable the boot message that is normally printed out when the system is booting. Note: It is still possible to press an (uppercase) A to enter the setup prompt during boot.

      If you wish to completly disable stdo, you should comment out the iprintf statements in the ip.cpp file. These statments are located around line 630.


    2. How can I change the wait time of my NetBurner device

      There are two ways to do this:

      If networking is enabled in your application:

      • Open up IP Setup (Start --> Programs --> Netburner NNDK --> IP Setup tool)
      • Select your NetBurner device in the "Select a Unit" window
      • Click on the "Advanced..." button in the IP Setup window
      • Change the "Boot Delay" option to whatever value (in seconds) that you want
      • Close the IP Setup application

      If you do not have networking enabled, you can use MTTTY to change the wait time of your NetBurner device:

      • Attach a serial cable (use a NULL modem cable for an SB72EX), from your host computer to your NetBurner device
      • Open up MTTTY (Start --> Programs --> Netburner NNDK --> Mttty Serial Terminal), reset your NetBurner device, and type an uppercase A (i.e. A) in the MTTTY window before the (current) wait time expires to get into the NetBurner monitor program. You will see the NetBurner prompt (i.e. nb>) in the MTTTY window
      • At the nb> prompt type the word setup and press the Enter key on your keyboard. You are now in the MTTTY setup screen
      • Change option 7 (wait) to whatever value (in seconds) that you want. Remember to press the S key on your keyboard to save the change, then press the X key to exit out of the setup program

      WARNING: If you do not have networking enabled in your application and you set the wait time to 0, you will be unable to change the wait time.


  4. NBEclipse Related

    1. NBEclipse gets internal error during early startup

      The most common issue that causes this is that you are running Java 1.4. You should upgrade to the latest Java JDK, and this problem will resolve itself.


    2. NBEclipse is running low on memory, how do I fix this

      NBEclipse can be a memory intensive application, depending much on the size of your application. At a minimum, you should have 512 MB of ram in your machine. If you have less then this, the best solution for you is to upgrade the amount of RAM in your machine.

      One way that you can reduce the memory footprint on these large projects would be to disable the indexer. To do this, right click on project and go to properties. Under C/C++ Indexer, select No Indexer. Now, restart NBEclipse and see if that improves your memory situation.

      Another solution to try is to increase the memory available to NBEclipse. Create a windows shortcut to NBEClipse.exe (right click, create shortcut). On the shortcut, right click and go to properties. Change the target from

      C:\Nburn\NBEclipse\NBEclipse.exe
      to
      C:\Nburn\NBEclipse\NBEclipse.exe -Xmx512M

      Run NBEclipse with the shortcut, and you should have more memory available. If you still get a failure, try 1024M.