1.12 TCP/IP TCP Client Server Using ATMAC

This demonstration is a combination of the TCP Client and TCP Server application using AT24MAC Serial EEPROM.

It shows the usage of MPLAB Harmony TCP API to implement:

  • A TCP echo server on port 9760.

  • A TCP client that establishes TCP/IP connection to a TCP server.

The Atmel AT24MAC402 and AT24MAC602 provides 2048 bits of Serial Electrically-Erasable Programmable Read-Only Memory (EEPROM) organized as 256 words of eight bits each and is accessed via an I2C-compatible (2-wire) serial interface.

TCP/IP TCP Client Server Using ATMAC MCC Configuration

The following Project Graph diagram shows the Harmony components included in the TCP Client Server Using ATMAC demonstration application.

  • MCC is launched by selecting Tools > Embedded > MPLAB® Code Configurator from the MPLAB X IDE and after opening the project, TCP/IP demo project is ready to be configured and regenerated.

  • TCP/IP Root Layer Project Graph

    The root layer project shows that USART1 peripheral is selected to do read and write operation for TCP/IP commands.

    This is the basic configuration with SYS_CONSOLE, SYS_DEBUG and SYS_COMMAND modules. These modules are required for TCP/IP command execution.

    tcpip_same70_v71_project

    The Two-wire Interface (TWIHS) interconnects components on a unique two-wire bus. It is used with Two-wire Interface bus Serial EEPROM ( ATMAC ) , I²C-compatible device.

    TCP sockets calculate the ISN using the wolfSSL crypto library.

  • TCP/IP Configuration

    1. SAM E70 Xplained Ultra

      tcpip_same70_v71_project

    2. SAM V71 Xplained Ultra

      tcpip_same70_v71_project

  • TCP/IP Required Application

    TCP/IP demo use these application module components for this demo.

    Announce module to discover the Microchip devices within a local network.

    DHCP Client module to discover the IPv4 address from the nearest DHCP Server.

    DNS Client provides DNS resolution capabilities to the stack.

  • TCPIP Data Link Layer

    Internal ethernet driver(gmac) is enabled with the external LAN8740 PHY driver library for SAME70 demonstartion.

    For SAM V71 demonstration , LAN8061 PHY driver ia selcted along with GMAC Internal ethernet driver.

    The MIIM Driver supports asynchronous read/write and scan operations for accessing the external PHY registers and notification when MIIM operations have completed.

TCP/IP TCP Client Server Using ATMAC Hardware Configuration

This section describes the hardware configuration for ATSAM E70/V71 Xplained Ultra Evaluation Kit and one can be used for the respective application demonstration.

  1. This section describes the required default hardware configuration use SAM E70 Xplained Ultra Evaluation Kit

    • Ensure ERASE jumper is Open.

    • Open the J805 Jumper

    • Refer to the SAM E70 Xplained Ultra User Guide

      required_hardware
    • Insert the LAN8740 PHY daughter board on the ETHERNET PHY MODULE header.

    • Connect the micro USB cable from the computer to the DEBUG USB connector on the SAM E70 Xplained Ultra Evaluation Kit

    • Establish a connection between the router/switch with the SAM E70 Xplained Ultra Evaluation Kit through the RJ45 connector

      required_hardware
  2. This section describes the required default hardware configuration use SAM V71 Xplained Ultra Evaluation Kit

    • No hardware related configuration or jumper setting changes are necessary

    • Ensure ERASE jumper is Open

    • Refer to the SAM V71 Xplained Ultra User Guide

      required_hardware
    • Connect the micro USB cable from the computer to the DEBUG USB connector on the SAM V71 Xplained Ultra Evaluation Kit

    • Establish a connection between the router/switch with the SAM V71 Xplained Ultra Evaluation Kit through the RJ45 connector

      required_hardware

TCP/IP TCP Client Server Using ATMAC Running Application

This table list the name and location of the MPLAB X IDE project folder for the demonstration.

Project NameTarget DeviceTarget Development BoardDescription
sam_e70_xult.XATSAME70Q21BSAME70 Xplained Ultra + LAN8740 PHY Daughter boardDemonstrates the TCP Client Server using ATMAC on development board with ATSAME70Q21B device and LAN8740 PHY daughter board. This implementation is based on Bare Metal ( non-RTOS).
sam_v71_xult.XATSAMV71Q21BSAMV71 Xplained UltraDemonstrates the TCP Client Server using ATMAC on development board with ATSAMV71Q21B device and KSZ8061 PHY daughter board. This implementation is based on Bare Metal (non-RTOS).

Running Demonstration Steps

  1. Build and download the demonstration project on the target board.

  2. If the board has a UART connection:

    1. A virtual COM port will be detected on the computer, when the USB cable is connected to USB-UART connector.

    2. Open a standard terminal application on the computer (like Hyper-terminal or Tera Term) and configure the virtual COM port.

    3. Set the serial baud rate to 115200 baud in the terminal application.

    4. See that the initialization prints on the serial port terminal.

    5. When the DHCP client is enabled in the demonstration, wait for the DHCP server to assign an IP address for the development board. This will be printed on the serial port terminal.

      • Alternatively: Use the Announce service or ping to get the IP address of the board.

      • Run tcpip_discoverer.jar to discover the IPv4 and IPv6 address for the board.

  3. Execution :

    1. After the successful board bring up, the console output becomes

      tcpip_tcp_client_project
      • By entering the command netinfo, the response is obtained as shown above.

      • As highlighted in the above screenshot, the MAC address of the Serial EEPROM is printed instead of the default board’s MAC address as provided in the DLL’s MAC component. This indicates that the AT24MAC Serial EEPROM is used in this application.

    2. For TCP Client test, input the following command from the serial port:

      openurl < url > - The < url > argument must be a fully formed URL; for instance, http://www.microchip.com/.

      For this above URL , the DNS module will make a DNS query. Then it will open a connection to the requested URL and perform a simple HTTP GET command.

      The response received from the server will be printed on the terminal application through the serial port.

      The expected output -

      tcpip_tcp_client_project
    3. For TCP Server test, the TCP Client application is required to run on the computer (SocketTest, Packet Sender etc). In this demonstration, we use the program, SocketTest (http://sockettest.sourceforge.net/). This demonstration is tested with SocketTest v3.0.

      Send a TCP packet to the IP address of the hardware board using port 9760 from any TCP Client application running on the computer (SocketTest is used here).

      The TCP Server demonstration running on the evaluation kit will echo back everything it receives along the connection.

      tcpip_same70_v71_project