onsemi EVBUM2833 Evaluation Kit User Manual
- June 12, 2024
- onsemi
Table of Contents
- Introduction
- Features
- APPLICATIONS INFORMATION
- Kit Content
- Raspberry Pi Setup and Operation
- Preparing, Compiling, and Running the Demo Application
- Listing 1: TAP CONFIGURATION
- Connecting a Microcontroller
- Setting Up a Network
- NCN26010XMNEVB Schematic
- NCN26010BMNEVB Bridge Board Schematic
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
onsemi EVBUM2833 Evaluation Kit User Manual
Introduction
The NCN26010XMNEVK 10BASE-T1S MACPHY evaluation kit is a set of PCBs designed to allow customers access to onsemi’s NCN26010 SPI enabled 10BASE-T1S MACPHY. Its main purpose is to demonstrate the MACPHY’s basic functionality and doubles as a lab tool to allow customers to develop their own embedded software drivers for the NCN26010 device.
Features
The evaluation kit consists of the NCN26010BMNEVB bridge board and the NCN26010XMNEVB 10BASE-T1S evaluation board.
The bridge board provides a power connector that allows feeding the boards with a DC supply of anything between 8 V and 28 V. For full operation, when a Raspberry Pi Model 3 is connected to the board, the power supply needs to be able to provide 10 W of continuous power.
The NCN26010XMNEVB evaluation board, carrying the NCN26010 has two RJ45 connectors that allow attaching a twisted single pair data cable. For ease of use, standard cat 5 Ethernet cables can be connected to the RJ45 connectors. Note that only one pair (connected to pin 1 and 2) of the RJ45 connector is used.
The SPI connection can be done through a PMOD connector on the NCN26010 evaluation board, allowing the connection to MCU demo and eval boards of various vendors. One example of such an Eval board is onsemi’s RSL10 BDK-GEVK.
To allow monitoring the SPI traffic, the EVB features a 0.1″ pitched pin
header that is easily accessible. This header could also be used to connect a
logic analyzer, allowing tracing of the SPI signals while in full operation
together with a (not supplied) Raspberry Pi or any other suitable Host MCU or
SBC.
The bridge board not only acts as a power supply for the NCN26010 evaluation
board, but also powers a Raspberry
Pi that can be connected to the 40-pin female connector, bringing the SPI and interrupt request signals from the NCN26010 MACPHY to the corresponding pins on the Raspberry Pi SBC.
After trying different models of Raspberry Pi single board computers, onsemi got best results with Raspberry Pi 3B and 3A+ models running “off the shelf” Raspberry OS with some software tools installed.
See section “Raspberry Pi Setup and Operation” for a list of suggested tools.
When using a Raspberry Pi model 3 with a 10/100 Ethernet interface, T1S can be bridged with this port allowing connection to a regular PC.
APPLICATIONS INFORMATION
For details of the NCN26010BMNEDB and NCN20610XMNEVB boards that make the
NCN26010XMNEVK, please consult the user guides of these boards.
The 10BASE-T1S evaluation board needs a host computer to perform any network
communication. The NCN26010 performs the functions of a MAC (media access
controller) and a PHY (physical layer) device.
The upper layer protocols need to be provided by software running on the host. The host will also have to handle the SPI communication between the MACPHY and the host, since the MACPHY operates as an SPI slave device.
In addition, the MACPHY provides an IRQ signal that signals new RX data and other events that need to be handled by the host.
Kit Content
An Evaluation Kit contains one NCN26010XMNEVB 10BASE-T1S MAPHY evaluation bard and one NCN26010BMNEVB bridge board which can be used to connect Raspberry Pi SBCs. Note that the Raspberry Pi is not supplied as part of the kit and needs to be externally sourced by the user of this kit.
Raspberry Pi Setup and Operation
By the nature of Ethernet, the board will only be functional when connected to a host computer which provides the upper layer protocols (like ARP, ICMP and TCP/IP or alike).
For simplicity, onsemi decided to use a proven, Linux based platform for this
purpose to minimize the amount of development and get to a working solution
quickly.
The Raspberry Pi is not provided and needs to be provided by the user.
onsemi recommends using a Raspberry Pi 3 B+ or Raspberry Pi 3 A+.
Preparing the Raspberry Pi
A 16 GB micro SD card is required as mass storage on the
Raspberry Pi SBC.
The following steps need to be executed to make the Raspberry Pi work as
expected:
1. Obtain Raspberry OS in its latest version and install it on the SD card as explained on the Raspberry Foundations web site at https://www.raspberrypi.org/software/
2. When running headless (without a monitor attached), create an empty file called “ssh” in the /boot directory of the SD card in which the Raspberry OS is installed. There is no harm to enable SSH even if you intend to run a Desktop environment
3. Boot the Raspberry Pi (one for every board), login, and run sudo raspi- config
a. Using “1 System Options” “S4 Hostname”, set a UNIQUE host name
b. Enable the SPI interface by using “3 Interface Options” “P4 SPI”
c. Depending on the specific application needs, enable or disable the Camera- Interface, I2C, UART or the Remote GPIO and appropriately configure all other settings.
4. Reboot the Raspberry Pi
5. Install additional software For performance measurements onsemi suggests
installing “iperf3” which allows you to measure data throughput between two
nodes
The Raspberry Pi needs to be connected to the internet to install software
from the Raspberry Pi repository
Open a console on the Raspberry (either via ssh or using the desktop) and
type:
sudo apt-get update
sudo apt-get install iperf3
Note that the update command only needs to be done once.
Install all other software tools following the same approach.
Tools that might be needed:
-
tcpdump
-
Wireshark
-
Bridge tools, for bridging the T1S with the 100Base
TX port of the Raspberry Pi.
This would allow you to integrate a regular PC into the T1S subnet using one Raspberry Pi as a bridge -
A DHCP server of your choice if you want a bridge to configure a connected PC automatically
Preparing, Compiling, and Running the Demo Application
The demo application prepared to run on Raspberry Pi is a user space “driver”
that provides routines to read and write Ethernet frames to/from the 10BASE-
T1S connected MACPHY and allows reading and writing configuration registers,
allowing testing features provided by NCN26010
Among others these features are:
- Switching between PCLA and CSMD/CD mode of operation
- Configure various aspect of the PLCA mode (ID, burst rate, max IDs)
- Enable/Disable ENI (enhanced noise immunity) mode
The T1_MACPHYDriver program makes use of the tun/tap interface provided by Linux.
This “virtual” network interface allows layer 2 Ethernet frames to be exchanged between a user space program and the Linux kernel. The Linux kernel provides the upper layer protocols above layer 2 of the OSI-ISO. Namely, this is the TCP/IP stack.
Once up and running, the 10BASE-T1S MACPHY is presented to the Linux operating system on the “tap0” interface and will act like any other network interface in the system.
Compiling
onsemi’s demo application runs in a Linux console. The application is
available pre-compiled on request or it can be downloaded at
https://www.onsemi.com
Users do not have to compile the application themselves, instead they can just
copy the program into the home directory of the Raspberry Pi.
On request, onsemi can make available the source code of this application. The
source code will contain instructions on how to compile the application.
Running the Program
Before the program can be started, the tap interface needs to be initialized
on the Raspberry Pi. To do this, execute these commands. Note that all these
need to run as root.
Listing 1: TAP CONFIGURATION
Note that every station needs to be assigned a unique IP address and a MAC address. For experiments with Packet Filtering, Packet sniffing (using Wireshark) it is beneficial to choose hostname, IP address and MAC address to be somewhat related.
In the above example, we named the host “pi03” assigned it a 10.1.1.3 address and made the last significant three bytes of the MAC address match the last three bytes of the IP address.
Also, note that we set the tap 0 to half duplex and its speed to 10 Mbit/s. This way we avoid the queues in the Linux TCP/IP stack to send data that the MACPHY will never be able to handle.
Once the tap is initialized, start the T1S driver as root:
sudo ./T1S
When running, the application accepts a small number of commands to make changes to the MACPHYs configuration on the fly.
Commands
1. Read a register:
To read a MACPHY register, type:
R
Example:
2. Write to a register
To write a register type:
W
Example:
3. Reporting Link (MAC) statistics
The MACPHY has several statistics counter (see product preview for details)
To read all these registers in one go and get a human readable report of the
counted events, simply type: S
Example:
4. Quit the “driver”
To stop the driver, simply type: Q
Command Line Options
The driver offers two command line options
1. PLCA
To make starting in PLCA operation simpler than having to configure the
correct registers manually, a command line option has been added to the
program For starting the head node, use:
-plca 0
Where
-plca
Note that the ID must be larger than zero and smaller than max ID
0<= ID <= max ID
2. ServerMode
When you intend to start the driver at startup or in the background,
“ServerMode” as a command line option. This will disable the interactive user
interface.
Connecting a Microcontroller
The NCN26010XMNEVB evaluation board is designed to allow customers to use a Microcontroller of their choice and interface with the MACPHY driver using the SPI interface.
This connection can either be done through the PMOD connector on the evaluation board or through the debug and monitoring connecter on the lower edge of the evaluation board. For details, please consult the NCN26010XMNEVB user guide, available at https://www.onsemi.com
On request, onsemi can provide some example implementations for select number of different MCUs, onsemi’s RSL10 BLE radio chip with integrated low power Cortex M3 being one of them.
A suitable Microcontroller needs to operate the SPI at >= 15 MHz and support interrupts though GPIO to be able to react to service requests issued by the MACPHY through the IRQ signal.
Setting Up a Network
To setup a functional T1S network, connect a twisted pair unshielded cable on the J1 connectors (dual RJ45). J1 makes a physical connection of the two RJ45 sockets, allowing users to use standard ethernet cables or crimp their one SPE cables using cheap plastic unshielded JR45 connectors.
Note that you can connect more than two boards to the same cable. Per IEEE standard, a maximum cable length of 25m and eight stations can be used on the same cable.
Results may vary with different wire gauges and PHY settings (i.e. ENI mode should give a higher count of possible stations and/or an extended reach).
When assigning the stations with IP addresses of the same network, you can use Linux standard tools like ping to check if there is a connection between all the stations.
In addition, you can point Wireshark to the tap0 interface to monitor the network traffic.
Note that by default, the driver program operates the MACPHYs in “promiscuous” mode, where every station forwards all frames to the TCP/IP stack, regardless of its destination address.
You can configure address filtering to limit the traffic on the SPI interface especially in situation where you use microcontrollers that might not have the performance to deal with the amount of traffic on the SPI when using “promiscuous” mode.
See datasheet and application note for details on how the address filtering works.
Custom configurations can be put into a “MACPHY_Configfile.txt” configuration file. If a file with that name is in the same directory as the actual application program, the program executes register writes contained in that file upon start up, hence configuring the MACPHY accordingly.
Here is a sample content:
NCN26010XMNEVB Schematic
NCN26010BMNEVB Bridge Board Schematic
All brand names and product names appearing in this document are registered trademarks or trademarks of their respective holders.
onsemi, and other names, marks, and brands are registered and/or common law trademarks of Semiconductor Components Industries, LLC dba “onsemi” or its affiliates and/or subsidiaries in the United States and/or other countries. onsemi owns the rights to a number of patents, trademarks, copyrights, trade secrets, and other intellectual property. A listing of onsemi’s product/patent coverage may be accessed at www.onsemi.com/site/pdf/Patent- Marking.pdf. onsemi is an Equal Opportunity/Affirmative Action Employer. This literature is subject to all applicable copyright laws and is not for resale in any manner.
The evaluation board/kit (research and development board/kit) (hereinafter the “board”) is not a finished product and is not available for sale to consumers. The board is only intended for research, development, demonstration and evaluation purposes and will only be used in laboratory/development areas by persons with an engineering/technical training and familiar with the risks associated with handling electrical/mechanical components, systems and subsystems. This person assumes full responsibility/liability for proper and safe handling. Any other use, resale or redistribution for any other purpose is strictly prohibited.
THE BOARD IS PROVIDED BY ONSEMI TO YOU “AS IS” AND WITHOUT ANY REPRESENTATIONS OR WARRANTIES WHATSOEVER. WITHOUT LIMITING THE FOREGOING, ONSEMI (AND ITS LICENSORS/SUPPLIERS) HEREBY DISCLAIMS ANY AND ALL REPRESENTATIONS AND WARRANTIES IN RELATION TO THE BOARD, ANY MODIFICATIONS, OR THIS AGREEMENT, WHETHER EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING WITHOUT LIMITATION ANY AND ALL REPRESENTATIONS AND WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, NON-INFRINGEMENT, AND THOSE ARISING FROM A COURSE OF DEALING, TRADE USAGE, TRADE CUSTOM OR TRADE PRACTICE.
onsemi reserves the right to make changes without further notice to any board.
You are responsible for determining whether the board will be suitable for your intended use or application or will achieve your intended results. Prior to using or distributing any systems that have been evaluated, designed or tested using the board, you agree to test and validate your design to confirm the functionality for your application. Any technical, applications or design information or advice, quality characterization, reliability data or other services provided by onsemi shall not constitute any representation or warranty by onsemi, and no additional obligations or liabilities shall arise from onsemi having provided such information or services.
onsemi products including the boards are not designed, intended, or authorized for use in life support systems, or any FDA Class 3 medical devices or medical devices with a similar or equivalent classification in a foreign jurisdiction, or any devices intended for implantation in the human body. You agree to indemnify, defend and hold harmless onsemi, its directors, officers, employees, representatives, agents, subsidiaries, affiliates, distributors, and assigns, against any and all liabilities, losses, costs, damages, judgments, and expenses, arising out of any claim, demand, investigation, lawsuit, regulatory action or cause of action arising out of or associated with any unauthorized use, even if such claim alleges that onsemi was negligent regarding the design or manufacture of any products and/or the board.
This evaluation board/kit does not fall within the scope of the European Union directives regarding electromagnetic compatibility, restricted substances (RoHS), recycling (WEEE), FCC, CE or UL, and may not meet the technical requirements of these or other related directives.
FCC WARNING This evaluation board/kit is intended for use for engineering development, demonstration, or evaluation purposes only and is not considered by onsemi to be a finished end product fit for general consumer use. It may generate, use, or radiate radio frequency energy and has not been tested for compliance with the limits of computing devices pursuant to part 15 of FCC rules, which are designed to provide reasonable protection against radio frequency interference. Operation of this equipment may cause interference with radio communications, in which case the user shall be responsible, at its expense, to take whatever measures may be required to correct this interference.
onsemi does not convey any license under its patent rights nor the rights of others.
LIMITATIONS OF LIABILITY: onsemi shall not be liable for any special, consequential, incidental, indirect or punitive damages, including, but not limited to the costs of requalification, delay, loss of profits or goodwill, arising out of or in connection with the board, even if onsemi is advised of the possibility of such damages. In no event shall onsemi’s aggregate liability from any obligation arising out of or in connection with the board, under any theory of liability, exceed the purchase price paid for the board, if any.
The board is provided to you subject to the license and other terms per onsemi’s standard terms and conditions of sale. For more information and documentation, please visit www.onsemi.com.
ADDITIONAL INFORMATION
TECHNICAL PUBLICATIONS:
Technical Library: www.onsemi.com/design/resources/technical-
documentation
onsemi Website: www.onsemi.com
ONLINE SUPPORT: www.onsemi.com/support
For additional information, please contact your local Sales Representative at
www.onsemi.com/support/sales
References
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>