YTTEK YTPC100 Series User manual

Page1 of 48
YTPC100-series
Platform Quick Start Guide
For MATLAB Development Environment
Deliver date: 2023/Aug.
Version：1.8

Page2 of 48
Outline
1. INTRODUCTION...................................................................................................................... 4
2. GETTING STARTED.................................................................................................................. 5
3. VERIFYING THE KIT CONTENTS .............................................................................................. 6
3.1 K IT C ONTENTS .................................................................................................................... 6
3.2 INSTALLING YTPC100-SERIES PLATFORM................................................................................. 7
3.3 YTPC100 P LATFORM F RONT P ANEL ..................................................................................... 8
3.4 PLATFORM F RONT P ANEL LED INDICATORS ............................................................................. 9
3.5 YTPC100 P LATFORM B ACK P ANEL ..................................................................................... 10
3.6 PLATFORM B ACK P ANEL LED INDICATORS ............................................................................. 11
3.7 S YNCHRONIZING M ULTIPLE P LATFORMS ............................................................................... 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
4.4 MATLAB APPLICATION SETTING........................................................................................... 17
5. PLATFORM SOFTWARE QUICK START.................................................................................. 18
5.1 STEP1: INITIALIZATION ........................................................................................................ 18
5.2 STEP2: RUN EXAMPLE......................................................................................................... 19
5.3 STEP3: GRAPHICAL USER INTERFACE (GUI) QUICK START.......................................................... 20
6. INTRODUCTION OF MATLAB APIS AND EXAMPLES ............................................................ 23
6.1 TRANSMIT I/Q RAW DATA : TX() ........................................................................................... 23
6.2 RECEIVE I/Q DATA : RX()..................................................................................................... 25

Page3 of 48
6.3 TRX LOOP BACK : TX_RX()................................................................................................. 27
6.3.1 Example 1: Single Tone Loopback Test ......................................................................... 27
6.3.2 Example 2: OFDM Loop Back Test................................................................................ 29
6.4 DE MODE : RX_DE()......................................................................................................... 29
6.4.1 Timeout Setting for RX_DE Mode ................................................................................ 31
6.4.2 Example 3: Round Trip Delay Test ................................................................................ 32
6.4.3 TX_RXDE(tx_data)........................................................................................................ 34
6.5 OFDM EXAMPLE ............................................................................................................... 35
6.5.1 Example 4: OFDM EVM Test with Coding (Transfer Pictures) ...................................... 35
6.5.2 Example 5: MIMO OFDM Test...................................................................................... 35
6.5.3 Example 6: 4x4 MIMO OFDM Test ............................................................................... 39
6.6 RECEIVE GAIN CONTROL / TRANSMIT POWER CONTROL ........................................................... 42
6.6.1 set_RX_Gain() .............................................................................................................. 42
6.6.2 set_TX_Attenuation()................................................................................................... 43
6.7 SET CENTER FREQUENCY : LO_CHANGE() ............................................................................ 45
6.8 CHANGE YTPC IP ADDRESS : IP_CHANGE()............................................................................ 45
7. APIS FOR YTPC-E-SERIES....................................................................................................... 46
7.1 SET ENHANCE BOARD STATE: SET_EK_LB();............................................................................ 46
7.2 SET TRANSMITTED POWER: SET_TX_POWER()........................................................................ 46
7.3 YTPC1004E LO CHANGE WITH CALIBRATION: LO_CHANGE_YTPC1004E() .............................. 46
8. TROUBLESHOOTING............................................................................................................. 47
9. DOCUMENT VERSION HISTORY ........................................................................................... 48

Page4 of 48
1. Introduction
YTPC100x/YTPE100x series
Features:
RF Capabilities
• Maximum 4 TX, 4 RX
• 300 MHz to 6 GHz frequency band
• Up to 100 MHz bandwidth per channel
Baseband Processing
• Xilinx FPGA
Software
• MATLAB
• C/C++
Synchronization
• Clock reference with external clock and
synchronous signal
• PPS time reference with GPS (optional)
Trigger mode
• Pulse trigger
Peripherals
• 1 RJ45 (1 GbE)
• 2 SPF+ (2 10GbE) [TBD]
• 1 Type B USB Host
Power
• 12V
Form Factor
• 327.9mm x 318 mm x 69.4 mm
Applications:
•WiFi IEEE802.11b/11a/11n/11ac
•Bluetooth
•4G LTE TDD/FDD transceiver
•5G NR sub-6GHz RF transceiver
•NB-IoT

Page5 of 48
2. Getting Started
The purpose of this document is to familiarize users with the feaures and usage of YTPC100-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 YTPC100-Series platform.
＊If users are using this platform for the first time, please operate it as the following steps:

Page6 of 48
3. Verifying the Kit Contents
3.1 Kit Contents
1. YTPC/YTPE100x platform
2. DC Power adapter 12V / 7A with 110V power cord
3. Type-B USB (Male) to Type-A USB (Male) cable
4. SMA (Male)-to-SMA (Male) cable 8 pieces
5. Ethernet cable category 6
⚫Preparing the Environment
Ensure that the environment users are using the YTPC100 platform in meets the following specifications.
Ambient temperature range
10 °C to 60 °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 YTPC100 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 yourself

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

Page8 of 48
3.3 YTPC100 Platform Front Panel
Connector
Use
USB 2.0
A JTAG interface that connects the host computer to the device FPGA for update
purposes. This port can be used with the Xilinx iMPACT configuration tool to load
a new bitfile provided by YTPC100 platform.
SMA
Tx1
Input or output terminal for the sub-6GHz RF signal on channel 1, 2, 3 or 4.
⚫female SMA connector
⚫50 Ω impedance
⚫single-ended
Rx1
TX2
Rx2
TX3
RX3
TX4
RX4
RF DCI
A digital control signal interface that connects to the YTTEK RF module for beam-
forming realization. The part number of the connector is QTH-030-01-L-D-A
PWR
Power on/off switch button with green light.

Page9 of 48
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 48
3.5 YTPC100 Platform Back Panel
Connector
Use
PWR
Input the 12V DC power by power adapter in the YTPC100 kit contents.
The type of DC Jack is 2.5/5.5mm.
GPS ANT
YTPC100 provides GPS ANT to synchronize multiple YTPC100s, user can
contact YTTEK for this additional feature.
REF CLK
IN
Input/output terminal to accept/provide an external reference signal
from/for another compatible YTPC100 device such as the YTPC100 CLK
Buffer.
⚫female SMA connector
⚫50 Ω impedance
⚫30.72 MHz at CMOS 3.3 V
OUT
SF SYNC
IN
Input/output terminal to accept/provide a frame synchronization signal
from/for another compatible YTPC100 device such as the YTPC100 CLK
Buffer.
⚫female SMA connector
⚫50 Ω impedance
⚫CMOS 3.3 V
OUT
1G ETH
Connect to laptop for transaction of data and control signal. This port
donot support 10M/100M Ethernet.

Page11 of 48
3.6 Platform Back Panel LED indicators
LED
Description
Color
State
Indication
SYNC SF
Indicates whether multiple
SDRs are operated
together or not and the
role of SDR.
OFF
-
The transmitter or receiver side in
whole system contains only one
platform.
Green
Solid
The transmitter or receiver side in
whole system contains both master
and slave, and this YTPC100
platform is master.
Blinking
The transmitter or receiver side in
whole system contains both master
and slave, and this YTPC100
platform is slave.
REF CLK
Indicates the status of the
reference signal.
OFF
-
There is no external input reference
signal.
Green
Solid
The device has external input
reference signal but is not locked to
the external input reference signal.
Blinking
The device has external input
reference signal and is locked to the
external reference signal.
3.7 Synchronizing Multiple Platforms
To set up a highter channel-count system, users can synchronize two or more Platforms so that they share
clock and signals.
Please refer to YTPC-OP01 Synchronization Module Application-note-v1.0.pdf, or contact YTTEK for
technical support.

Page12 of 48
4. Configuring the Device and Computer Environment Setting
4.1 Required Software
The actual software used to prepare this document is mentioned in the below:
⚫MATLAB R2018a ~ R2022a
⚫Windows 10 (Win 64-bit)
4.2 Ethernet Interface
⚫Host Ethernet Interface—Single Device Configuration
⚫Host Ethernet Interface—Multiple Device Configuration
Users can synchronize multiple YTPC100x devices, and the IP address needs to be set before
synchronization. (Up to four devices can be synchronized.)
Description
IP Address
Host Ethernet interface
192.168.3.200
Default Device IP address
192.168.3.100
Description
IP Address
Host Ethernet interface
192.168.3.200
Device 0
192.168.3.100
Device 1
192.168.3.101
Device 2
192.168.3.102
Device 3
192.168.3.103

Page13 of 48
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 48
iii. Tick the label “using the following IP Address”. Fill the IP Address with 192.168.3.200, and
sub-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 close “Energy-saving
Enthernet”, click OK to finish Networking setting process.
Disabled
Power Saving Mode & Energy-saving Ethernet

Page15 of 48
＊Note: We recommend user to update ethernet driver to the latest version.
＊Note: If users need to use a 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 48
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 48
4.4 MATLAB Application Setting
Because the platform communicates with MATLAB via Ethernet, users need to add ARP (Address
Resolution Protocol) table in the first execution. The operation needs the administrator privileges.
Following the steps:
i. Right click on the icon of MATLAB, and choose “Properties”.
ii. Choose “Compatibility”, and tick the “Run this program as an administrator”
iii. MATLAB setting process is finished.

Page18 of 48
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:2.5.2456, HW
Version: xx” and “Initial Completed! ”.
The folder “Tool” contains all APIs for users. The related path of “Tool” will be added after platform be
initialized.

Page19 of 48
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. YTPC100-Series examples are divided into two categories: basic_function
and communication_example

Page20 of 48
5.3 Step3: Graphical User Interface (GUI) Quick Start
⚫M3FORCE provide GUI for users to get started quickly.
⚫SDR_GUI_Menu → Allow users to choose which GUI to execute.
Program: Please execute “SDR_GUI_Menu.p”
Run SDR_GUI_Menu: Users can choose which GUI to execute.
OFDM: (1) SISO OFDM (2) 2x2 MIMO OFDM (3) 4x4 MIMO OFDM.
RF Module: (1) 4x4 (2) 8x8 (3) 39GHz mmWave RF Module.