Network Component  Version 7.11.0
MDK Middleware for IPv4 and IPv6 Networking
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Telnet Server

Often, it is necessary to have a Command Line Interface (CLI) for interaction with the device. This example shows how to use the Telnet server for this purpose. The following picture shows an exemplary connection of the development board and a Computer.

telnet_setup.png

Build the "Telnet" Project

Open the example project in MDK (the web page explains how to do this). The ┬ÁVision Project window should display a similar project structure:

telnet_proj_structure.png
Telnet Client Project Structure

Source Files

  • Telnet_Server.c contains the main C function that initializes the board hardware and the Network Component.
  • The Telnet_Server_UIF.c defines the functions for the user interface and all the available CLI commands.
  • A Telnet_Server_Multiuser.c file can be added using the feature. This file is used for specifying multiple users and access rights for these users.
  • Adding the Telnet_Server_Access.c file enables the server to accept or block connection requests from certain remote clients.

You may now build and download the example project to the evaluation board using the ┬ÁVision commands:

  • Project –> Build target
  • Flash –> Download

After these steps, the project should start executing on your evaluation kit. In case of errors, refer to the Evaluation Board User's Guide for configuration information.

Using the "Telnet" Project

Hardware Setup

The setup of the Evaluation Board hardware is described in the Abstract.txt file.

  • Verify all jumper settings on the target hardware.
  • Use an Ethernet cable to connect your development board to the local area network. The PC is assumed to be already a member of this LAN.

PC Software

For opening a Telnet session, you need a Telnet client. As this is not an integral part of Windows any more, please look for an alternative on the Internet. PuTTY has a good feature set and is easy to install and use. When you connect to your board using a Telnet client, please enter my_host (or the respective hostname that you have chosen in the Net_Config.c file) in the hostname field and use the standard Telnet port 23. You will be asked for log-in credentials. Like for all other tutorials, the default is admin for the username without any password (you can change the defaults in the Net_Config_Telnet_Server.h file). Using the help command, you can see the list of available CLI commands:

telnet_cli.png
Telnet Command Line Interface