YTTEK Y.FORCE YTPC400 User manual

Page1 of 26
Y.FORCE YTPC400
Platform Quick Start Guide
For MATLAB Development Environment
Deliver date: 2023/Nov.
Version：2.1

Page2 of 26
Outline
1. INTRODUCTION...................................................................................................................... 4
2. GETTING STARTED.................................................................................................................. 5
3. VERIFYING THE KIT CONTENTS .............................................................................................. 6
3.1 K IT C ONTENTS .................................................................................................................... 6
3.2 INSTALLING YTPC400-SERIES PLATFORM................................................................................. 7
3.3 YTPC400 P LATFORM F RONT P ANEL ..................................................................................... 8
3.4 PLATFORM F RONT P ANEL LED INDICATORS ............................................................................. 9
3.5 YTPC400 P LATFORM B ACK P ANEL ..................................................................................... 10
3.6 YTPC400 P LATFORM S IDE P ANEL ...................................................................................... 11
4. CONFIGURING THE DEVICE AND COMPUTER ENVIRONMENT SETTING............................ 12
4.1 REQUIRED SOFTWARE ......................................................................................................... 12
4.2 ETHERNET INTERFACE.......................................................................................................... 12
4.3 CONFIGURING THE HOST ETHERNET INTERFACE ....................................................................... 13
5. PLATFORM SOFTWARE QUICK START.................................................................................. 17
5.1 STEP1: INITIALIZATION ........................................................................................................ 17
5.2 STEP2: RUN EXAMPLE......................................................................................................... 18
6. INTRODUCTION OF MATLAB APIS AND EXAMPLES ............................................................ 19
6.1 BASIC EXAMPLE ................................................................................................................. 19
6.1.1 Receive baseband data : RX_YTPC400() ...................................................................... 20
6.1.2 Transmit baseband data : TX_YTPC400()..................................................................... 21
6.1.3 TRX Loop Back : TX_RX_YTPC400() .............................................................................. 23
6.1.4 Example 1: Single Tone Loopback Test......................................................................... 23
6.2 COMMUNICATION EXAMPLE................................................................................................. 24

Page3 of 26
6.2.1 OFDM Loop Back Test .................................................................................................. 24
7. TROUBLESHOOTING............................................................................................................. 25
8. DOCUMENT VERSION HISTORY ........................................................................................... 25

Page4 of 26
1. Introduction
YTPC400x Series
Features:
RF Capabilities
• Maximum 2 TX, 2 RX
• 10 MHz to 9 GHz frequency band
• Up to 400 MHz bandwidth per channel
Baseband Processing
• 12-bit, 3.93216 Gsps ADC
• 14-bit, 3.93216 Gsps DAC
Software
• MATLAB
• C/C++
Synchronization
• REF IN (clock reference input)
• REF OUT (clock reference output)
• PPS IN (PPS time reference)
• TRIG IN
Trigger mode
• Pulse trigger
Peripherals
• 3.5mm SMA female
• 1 RJ45 (1 GbE)
• 1 USB to JTAG
Power
• 12V DC
Form Factor
• 275*280*74 mm
Applications:
•5G NR sub-6GHz RU
•5G mmWave RU
•WiFi 6E transceiver

Page5 of 26
2. Getting Started
The purpose of this document is to familiarize users with the feaures and usage of YTPC400-Series
platform. Use this document to help users get started with setting up the Platform and reviewing test
software. With this document, you will explore what you can do with the YTPC400-Series platform.
＊If users are using this platform for the first time, please operate it as the following steps:

Page6 of 26
3. Verifying the Kit Contents
3.1 Kit Contents
1. YTPC400x platform
2. DC Power adapter 12V with 110V / 220V power cord
3. SMA (Male)-to-SMA (Male) cable 2 pieces
4. 1G Ethernet cable
⚫Preparing the Environment
Ensure that the environment users are using the YTPC400 platform in meets the following specifications.
Ambient temperature range
0 °C to 45 °C
Optimized Operating temperature
23 °C ± 5 °C
Operating humidity
20% to 80% relative humidity, noncondensing
Indoor use only.
The platform is not waterproof and dustproof
Do not operate the YTPC400 platform in an environment not specified as above. Product misuse can
result in a hazard.
If the product is damaged, return it to YTTEK for repair. It is not recommended to repair by yourself.

Page7 of 26
3.2 Installing YTPC400-Series Platform
1. Use the Ethernet cable to connect the YTPC400-Series platform to the computer. Please do not
unplug the cable during operation.
2. Connect the 110V / 220V AC to 12V DC power adapter to the YTPC400-Series platform.
3. Plug the 110V / 220V power cord of power adapter into a wall outlet.
4. Connect SMA cables to confirm signal source.
5. Press PWR button and turn on platform.
⚫Uninstalling YTPC400-Series Platform
1. Press PWR button and turn off platform.
2. Plug out the 110V / 220V power cord.
3. Disconnect the 110V / 220V AC to 12V DC power adapter.
4. Plug out the Ethernet cable/SMA cables.

Page8 of 26
3.3 YTPC400 Platform Front Panel
Connector
Use
SMA
Tx1
Input or output terminal for the RF signal on channel 1 and 2.
⚫female SMA connector
⚫50 Ω impedance
⚫single-ended
Rx1
TX2
Rx2
DCI
A digital control signal interface that connects to the YTTEK RF module for beam-
forming realization.
PWR
Power on/off switch button.

Page9 of 26
3.4 Platform Front Panel LED indicators
The LEDs indicate indexes of platforms. The location of the lightening LED means the setting of the
Ethernet IP of this platform.
LED
Description
Color
State
Indication
IP
[0:3]
Indicate the IP number of
the device.
OFF
-
The network is not connected.
Green
Blinking
There is a problem with device initialization.
Green
Solid
The device has been assigned IP with the
format as below.
IP [0:3]
IP
role
192.168.3.100
(Default)
Master
192.168.3.101
Slave
192.168.3.102
Slave
192.168.3.103
Slave
＊Note: IP connection and LEDs status must be confirmed before Init.
＊Note: If user wants to change device IP, please refer to section 6.7 IP_Change().

Page10 of 26
3.5 YTPC400 Platform Back Panel
Connector
Use
DC IN
Input the 12V DC power by power adapter in the YTPC400 kit contents.
PL ETH
Connect to computer for transaction of data and control signal. This port
does not support 10M/100M Ethernet.
JTAG
A JTAG interface that connects the host computer to the device FPGA for
update purposes. This port can be used with the Xilinx configuration tool
to load a new bitfile provided by YTPC400 platform.
SD Card
A secure digital input/output (SDIO) interface to provide access to general
purpose non-volatile SDIO memory cards and devices.

Page11 of 26
3.6 YTPC400 Platform Side Panel
Connector
Use
10MHz
10MHz reference clock input/output for synchronizing with other
equipments.
PPS
PPS time input for time synchronization. Contact YTTEK for this additional
feature.
SYNC
Input/output port to accept/provide a synchronization signal from/to
another compatible device. This also acts as trigger input port in trigger
mode.
RSV
Reserved.

Page12 of 26
4. Configuring the Device and Computer Environment Setting
4.1 Required Software
The software used to prepare this document is listed in the following:
⚫MATLAB R2018a ~ R2023a
⚫Windows 10 (Win 64-bit)
4.2 Ethernet Interface
⚫Host Ethernet Interface—Single Device Configuration
Description
IP Address
Host Ethernet interface
192.168.3.200
Default Device IP address
192.168.3.100

Page13 of 26
4.3 Configuring the Host Ethernet Interface
Configure the host Ethernet interface with a static IP address, and set the IP address “192.168.3.200” on
the host computer. If users use Ethernet adapter, please use “USB 3.0 to gigabit Ethernet adapter”.
Following the steps:
i. Choose the network adapter which is connected to the platform. Right click on the network
adapter and choose “Properties”.
ii. Choosing the Internet Protocol Version 4 (TCP/IP). It is better to cancel all of the ticks in the
menu except Internet Protocol Version 4 (TCP/IP).

Page14 of 26
iii. Tick the label “using the following IP Address”. Fill the IP Address with 192.168.3.200, and
subnet mask with 255.255.255.0., click OK and finish IP setting process.
iv. Click the button “Configure…”, and select “Advanced” menu, change the value to turn off
Ethernet energy-saving status. For the high-speed transmission, please disable “Energy-saving
Ethernet”, click OK to finish Networking setting process.
Disabled
Power Saving Mode & Energy-saving Ethernet

Page15 of 26
＊Note: Update ethernet driver to the latest version is recommend.
＊Note: If users need to use an USB to Ethernet adapter, YTTEK recommends using Realtek or Intel USB 3.0 to
Gigabit Ethernet Adapter.
＊Note: If users use Ethernet adapter, please use “USB 3.0 to gigabit Ethernet adapter” and connect USB3.0 on
the PC side. If users use USB 2.0, the transmission speed will be reduced, and the Ethernet packets may be lost.

Page16 of 26
v. Turn off the firewall to prevent the firewall from blocking network packets.
vi. If user still have problems with the network connection according to the above steps, please
turn off antivirus software. And confirm if there is any software blocking the network packets.

Page17 of 26
5. Platform Software Quick Start
When the platform power is turned on and the network connection is confirmed, users can enter the
folder: “ .\release ” to initialize the platform. (The detail introduction of APIs in Chapter6.)
5.1 Step1: Initialization
First, enter “Init(type)” in the command window to initialize the platform.
⚫Type → 0: all platform are single, 1: Master slave mode. (If type is not entered, the default is
0.)
If the initialization is complete, the console would show the message “Software version:x.x.xxxx, HW
Version: xx” and “Initial Completed! ”.
The folder “Tool” contains all APIs for users. The related path of “Tool” will be added after platform is
initialized.

Page18 of 26
5.2 Step2: Run Example
When the initialization is complete, users can choose the example to test. The detailed example is
described in the next section. All YTPC400-Series examples are in the folder
“.\release_YTPC400\YTPC400_testing_code”.

Page19 of 26
6. Introduction of MATLAB APIs and Examples
This section will introduce all the YTTEK MATLAB APIs of YTPC400 platform. All APIs are in the folder
“.\release_YTPC400\tool\YTPC400”.
User can easily analysis the wireless communication by using the APIs on YTPC400 platform. This section
will introduce some examples of communication applications. User can quickly understand how to build
user’s own algorithm for communication systems based on our examples.
All the example code are in the folder: “.\ release_YTPC400\YTPC400_testing_code”.
6.1 Basic Example
YTTEK provides simple programs for user to be familiar with YTPC400 platform. The basic examples are
divided into three categories: “ RX Example ”, “ TX Example ” and “ Loopback Example ”. These programs
are based on APIs: “ RX_YTPC400() ”, “ TX_YTPC400() ” and “ TX_RX_YTPC400() ”.

Page20 of 26
6.1.1 Receive baseband data : RX_YTPC400()
⚫rx_data = RX_YTPC400(number_of_RX_chains, rx_len)
⚫Example path: “ .\YTPC400_testing_code\rx_scope_ex.m “
⚫Output rx_data will be a matrix based on real data.
⚫Use RX_YTPC400() to log baseband data as a scope.
User can use this platform as a scope to easily log baseband data from RF signal into a variable in MATLAB.
The maximum receive length is about 8e7 samples.
Program: rx_len → log length
rk is the variable of the baseband
data and data type is real. The
maximum length of rk is about
8e7 samples,