Using the NicheStack TCP/IP Stack - Nios II Edition Tutorial

Download PDF
ID 683574
Date 10/04/2021
Public
Document Table of Contents
Document Table of Contents x
1. Using the NicheStack TCP/IP Stack - Nios II Edition Tutorial
1. Using the NicheStack TCP/IP Stack - Nios II Edition Tutorial x
1.1. Introduction 1.2. Nichestack Support and Licensing 1.3. Hardware and Software Requirements 1.4. Tutorial Files 1.5. Software Development Flow 1.6. Nios II Simple Socket Server Overview 1.7. Important NicheStack TCP/IP Stack Concepts 1.8. Where to Go Next 1.9. Hardware Setup Details 1.10. Document Revision History for the Using the NicheStack TCP/IP Stack - Nios II Edition Tutorial
1.4. Tutorial Files x
1.4.1. Hardware Design Files 1.4.2. Software Files
1.5. Software Development Flow x
1.5.1. Creating a New Nios II Project 1.5.2. Configuring the BSP 1.5.3. Examining the Nios II Simple Socket Server Project Files 1.5.4. Building and Running the Nios II Simple Socket Server Project 1.5.5. Interacting with the Nios II Simple Socket Server
1.6. Nios II Simple Socket Server Overview x
1.6.1. Software Naming Conventions 1.6.2. Software Architecture 1.6.3. MicroC-OS/II Resources
1.6.3. MicroC-OS/II Resources x
1.6.3.1. Tasks 1.6.3.2. Inter-Task Communication Resources
1.7. Important NicheStack TCP/IP Stack Concepts x
1.7.1. Error Handling 1.7.2. NicheStack TCP/IP Stack Default Task Creation 1.7.3. Creating Tasks that Use the NicheStack TCP/IP Stack Sockets Interface 1.7.4. Task Priorities in the Nios II Simple Socket Server Design 1.7.5. Task Stack Size
1.7.4. Task Priorities in the Nios II Simple Socket Server Design x
1.7.4.1. MicroC/OS-II Internal Tasks 1.7.4.2. NicheStack TCP/IP Stack Internal Tasks 1.7.4.3. Networking Initialization Task 1.7.4.4. User Networking Tasks 1.7.4.5. User Non-Networking Tasks
1.9. Hardware Setup Details x
1.9.1. Network Connection
1. Using the NicheStack TCP/IP Stack - Nios II Edition Tutorial

1.5.2. Configuring the BSP

After you create a new BSP, you might want to customize its configuration (for example, defining stdin, stdout, stderr, and other parameters).

Note: For more information, refer to the Getting Started with the Graphical User Interface chapter of the Nios II Software Developer’s Handbook.

For this tutorial, you must configure the MicroC/OS-II RTOS kernel and NicheStack TCP/IP Stack software components. To do so, follow these steps:

  1. In the Project Explorer view, right-click the niosII_simple_socket_server_bsp project, point to Nios II, and click BSP Editor. The Nios II BSP Editor appears.
  2. On the Main tab expand Settings in the left pane, and click Common. Verify that the settings for the stdout, stdin, and stderr parameters are jtag_uart, as shown in the "BSP Editor Main Tab" figure.
    Figure 3. BSP Editor Main Tab
  3. On the Main tab expand Advanced in the left pane, and click ucosii. Settings for the MicroC/OS-II RTOS appear, as shown in the "MicroC/OS-II RTOS Options" figure.
    Figure 4. MicroC/OS-II RTOS Options

    The MicroC/OS-II kernel is highly configurable. The options that you set in this dialog box determine which MicroC/OS-II options are included in the binary image. Examine the configurable options by clicking each of the options categories under ucosii in the left pane. For this tutorial, do not change any of the settings.

    Although this example software design does not use all the MicroC/OS-II system calls, the NicheStack TCP/IP Stack internally uses many more MicroC/OS-II system calls, more than the Nios II Simple Socket Server application itself uses. Do not disable any system calls unless you need to be very conservative with your code size requirements. You must re-enable system calls that you try to disable if the link stage of the build fails with unresolved symbols.

    For more information about the various MicroC/OS-II features, refer to the MicroC/OS-II Real-Time Operating System chapter in the Nios II Software Developer's Handbook.

  4. On the Software Packages tab, turn on Enable for the altera_iniche software package, as shown in the "NicheStack TCP/IP Stack Options" figure.
    Figure 5. NicheStack TCP/IP Stack Options
  5. If a DHCP server is available on your network, turn on enable_dhcp_client. If no DHCP server is available, turn off enable_dhcp_client and specify your IP addresses, gateway, and network mask in <tutorial_files> \nichestack_tutorial\niosII_simple_socket_server.h.

    Take care when choosing your default IP and gateway addresses. Some secure router configurations block DHCP request packets on local subnetworks such as the 192.168.X.X subnetwork. If you do encounter problems, try using 0.0.0.0 as your default IP and gateway addresses.

  6. Click Generate. When prompted to save your changes, click Yes, Save.
  7. Click Exit on the File menu to close the BSP Editor and return to the Nios II SBT for Eclipse.
  8. In BSP project, you must add -DTSE_MY_SYSTEM to your defined symbols. Right-click the niosII_simple_socket_server_bsp project and click Properties. The Nios II BSP Properties page appears. On the left pane, click Nios II BSP Properties. In the Defined symbols box, type -DTSE_MY_SYSTEM.
  9. Click Apply and OK.
Related Information
Level Two Title