SMM-K507 Key features 1 Welcome to the ARB ethernet upload option The R&S SMM-K507 option ARB ethernet upload is a firmware application that allows high-speed streaming of waveform files via the QSFP+ interface of the R&S SMM100A. This user manual contains a description of the functionality that the application pro- vides, including remote control operation.
® Welcome to the ARB ethernet upload option R&S SMM-K507 Documentation overview 1.2 Accessing the ARB ethernet upload dialog To open the dialog with ARB ethernet upload settings 1. In the block diagram of the R&S SMM100A, select "Baseband > ARB".
® Welcome to the ARB ethernet upload option R&S SMM-K507 Documentation overview 1.4.2 User manuals and help Separate manuals for the base unit and the software options are provided for down- load: ● Base unit manual Contains the description of all instrument modes and functions. It also provides an...
® Welcome to the ARB ethernet upload option R&S SMM-K507 Notes on screenshots www.rohde-schwarz.com/brochure-datasheet/smm100a 1.4.7 Release notes and open source acknowledgment (OSA) The release notes list new features, improvements and known issues of the current firmware version, and describe the firmware installation.
Page 9
® Welcome to the ARB ethernet upload option R&S SMM-K507 Notes on screenshots The screenshots usually show a fully equipped product, that is: with all options instal- led. Thus, some functions shown in the screenshots may not be available in your par- ticular product configuration.
For more information, see data sheet. 2.2 About ARB ethernet upload Equipped with option R&S SMM-K507 ARB ethernet upload, the R&S SMM100A can upload waveforms significantly faster to its ARB memory. Data rates of 10 Gbit/s and 40 Gbit/s at the QSFP+ connectors "HS Dig I/Q" allow much shorter waveform loading times.
Page 11
® About the ARB ethernet upload option R&S SMM-K507 About ARB ethernet upload ware that supports the User Datagram Protocol (UDP IPv4, see Chapter A, "I/Q over Ethernet (QSFP+) protocol", on page 38). Figure 2-2 shows the different frames that are exchanged between R&S SMM100A and the PC.
® Uploading waveform files R&S SMM-K507 Connecting the R&S SMM100A 3 Uploading waveform files This chapter provides an overview on how to prepare, configure and operate the R&S SMM100A for waveform upload via the QSFP+ interface. ● Connecting the R&S SMM100A................12...
® Uploading waveform files R&S SMM-K507 Configuring the host PC To connect to LAN Optionally, connect the host PC and R&S SMM100A to LAN for remote control opera- tion via the SCPI interface. Use this connection to configure RF signal settings of the R&S SMM100A like frequency and power level.
Page 14
® Uploading waveform files R&S SMM-K507 Configuring the host PC 2. Configure the Ethernet network card, e.g., set the correct mode of operation for data transfer. See the documentation of the manufacturer of the network card. 3. Configure the Windows network settings of the Ethernet controller: IP address set- tings of the PC and IP version IPv4 4.
® Uploading waveform files R&S SMM-K507 Activating and monitoring waveform upload 3.3 Configuring the R&S SMM100A This chapter provides step-by-step instructions to configure ARB Ethernet upload at the R&S SMM100A. These instructions cover the following topics: ● "To enable ARB Ethernet upload"...
® ARB ethernet upload configuration and settings R&S SMM-K507 General settings 4 ARB ethernet upload configuration and set- tings Access: 1. Select "Baseband > ARB". 2. Select "Mode > Ethernet Upload". The dialog provides settings to configure settings and monitor characteristics of the ARB Ethernet upload.
Page 19
Sets the mode of the ARB application. "Standard" Standard ARB mode for playing waveform files using the internal baseband source. "Ethernet Upload" Requires R&S SMM-K507. ARB mode for uploading waveform files using the external QSFP+ interface. Remote command: on page 28 [:SOURce<hw>]:BB:ARBitrary:MODE...
® ARB ethernet upload configuration and settings R&S SMM-K507 Statistics Waveform Counter Displays the number of waveforms that are uploaded to and already played from the ARB memory. Remote command: on page 29 [:SOURce<hw>]:BB:ARBitrary:ETHernet:WAVeform:COUNter? Ethernet Mode Sets the mode for the waveform data upload via the Ethernet connection.
Page 21
® ARB ethernet upload configuration and settings R&S SMM-K507 Statistics 2. Select "Statistics". This tab displays statistics of ARB Ethernet upload characteristics including receive (Rx) statistics, transmit (Tx) statistics and error statistics. Settings: RX Upload Segments....................21 RX Control Frames....................... 21 RX Data Frames......................
® ARB ethernet upload configuration and settings R&S SMM-K507 Local QSFP network settings TX Reply Frames Displays the number of transmitted reply frames. Remote command: [:SOURce<hw>]:BB:ARBitrary:ETHernet:STATistics:TXRFrames? on page 33 Occurred Errors Displays the number of errors that occurred during ARB Ethernet upload.
Page 23
® ARB ethernet upload configuration and settings R&S SMM-K507 Local QSFP network settings Address Mode....................... 23 Address........................24 Subnet Mask......................... 24 Address........................ 24 Protocol......................... 24 Port........................24 Network Status Indicates that the instrument is connected to the network. Remote command: on page 34 :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:STATus?
Page 24
® ARB ethernet upload configuration and settings R&S SMM-K507 Local QSFP network settings Remote command: on page 35 :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:IPADdress:MODE IP Address Assign the IP address manually. Remote command: on page 36 :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:IPADdress Subnet Mask Assign the subnet mask manually. Remote command: :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork[:IPADdress]:SUBNet:MASK...
® Signal generation control R&S SMM-K507 5 Signal generation control In this chapter, the signal generation control functionality for ARB Ethernet upload mode is described. It includes trigger and marker settings. In particular, the difference of these settings compared to the standard ARB functionality is described.
® Remote control commands R&S SMM-K507 6 Remote control commands The following commands are required to generate signals with the ARB ethernet upload option in a remote environment. We assume that the R&S SMM100A has already been set up for remote operation in a network as described in the R&S SMM100A documentation.
® Remote control commands R&S SMM-K507 General commands 6.1 General commands Example: Activating ARB Ethernet upload This example requires that the R&S SMM100A is connected to the QSFP+ network, Example"Configuring the QSFP+ network" on page 34. // ******************************************************************************** // Enable ARB Ethernet upload mode.
Page 28
QSFP+ interface. *RST: STANdard Example: Example"Activating ARB Ethernet upload" on page 27. Options: EUPLoad requires R&S SMM-K507. Manual operation: "Mode" on page 19 [:SOURce<hw>]:BB:ARBitrary:ETHernet:MODE <Mode> Sets the Ethernet mode for the waveform data upload via the Ethernet connection. Parameters: <Mode>...
Page 29
® Remote control commands R&S SMM-K507 General commands "Running" Plays the waveform, that is loaded into the ARB memory of the R&S SMM100A. Example: Example"Activating ARB Ethernet upload" on page 27. Usage: Query only Manual operation: "Status" on page 19 [:SOURce<hw>]:BB:ARBitrary:ETHernet:WAVeform:COUNter?
® Remote control commands R&S SMM-K507 Statistics commands Query results are returned in a comma-separated list. Listed are pairs "<TagName>"<"<TagValue>"> for each tag. Query parameters: <TagName> string Name of the waveform tag. Return values: <TagValue> string Value of the waveform tag.
® Remote control commands R&S SMM-K507 Statistics commands SOURce1:BB:ARBitrary:ETHernet:STATistics:ERRors? // Response: "0" // No errors occured during the ARB Ethernet upload session. // ******************************************************************************** // Alternatively, query all results. // ******************************************************************************** SOURce1:BB:ARBitrary:ETHernet:STATistics:ALL? // Response: "15790","47470","31610","63220","89120","0" // Returs a comma-separated list of all result parameters: // "<RxUploadSegments>,<RxConrolFrames>,<RxDataFrames>,<RxDataBytes>,...
® Remote control commands R&S SMM-K507 Statistics commands <TxReplyFrames> integer Number of Tx reply frames, see [:SOURce<hw>]:BB: ARBitrary:ETHernet:STATistics:TXRFrames? on page 33. Example: Example"Monitoring ARB Ethernet upload characteristics" on page 30. Usage: Query only [:SOURce<hw>]:BB:ARBitrary:ETHernet:STATistics:ERRors? Queries the number of errors that occured during ARB Ethernet upload.
Page 33
® Remote control commands R&S SMM-K507 Statistics commands Manual operation: "RX Data Bytes" on page 21 [:SOURce<hw>]:BB:ARBitrary:ETHernet:STATistics:RXDFrames? Queries the number of data frames, that the R&S SMM100A receives from the PC. Return values: <DataFrames> integer *RST: Example: Example"Monitoring ARB Ethernet upload characteristics"...
® Remote control commands R&S SMM-K507 QSFP+ network commands 6.3 QSFP+ network commands Example: Configuring the QSFP+ network // ******************************************************************************** // Configuring QSFP+ 1 network parameters at the connector HS Dig I/Q1. // ******************************************************************************** // Set the IP address. SYSTem:COMMunicate:BB1:QSFP:NETWork:IPADdress "127.0.0.1"...
Page 35
® Remote control commands R&S SMM-K507 QSFP+ network commands Example: Example"Configuring the QSFP+ network" on page 34. Usage: Query only Manual operation: "Network Status" on page 23 :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:APPLication? Queries a running application. Return values: <RunningApp> string Returns the name of the running application.
Page 36
® Remote control commands R&S SMM-K507 QSFP+ network commands Manual operation: "Address Mode" on page 23 :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:IPADdress <IpAddress> Sets the IP address. Parameters: <IpAddress> String Range: 0.0.0.0 to ff.ff.ff.ff Example: Example"Configuring the QSFP+ network" on page 34. Manual operation: "IP Address"...
® Remote control commands R&S SMM-K507 Trigger, marker and clock commands :SYSTem:COMMunicate:BB<hw>:QSFP:NETWork:PORT <PortNumber> Sets the port address used for network traffic. Parameters: <PortNumber> integer Range: 0 to 65536 *RST: n.a. (factory preset: 49152) Example: Example"Configuring the QSFP+ network" on page 34.
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 UDP/IP protocol stack ● The header of the I/Q classifies the frame type used in the I/Q frame. ● A waveform consists of one or more waveform segments. ● The segment length is a multiple of 512 bytes. If a segment is shorter, missing bytes are added to the payload (padding).
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 UDP/IP protocol stack A.1.4 ACK frame The acknowledgement (ACK) frame carries 64-bit information divided into three frame fields. Figure A-2 displays the frame composition and Table A-2 describes frame field bit information.
Page 41
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 UDP/IP protocol stack Table A-3: Control frame types Frame type/command Cmd/ Payload Reply Description and requirements payload (Bytes) code (6 Bits) C_START_SESSION The host PC sends this frame type at least once when ini- tiating the upload session.
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 Waveform upload command sequences A.4 Waveform upload command sequences APPL command Use the application layer (APPL) command APPL-Command (CmdCode= ‚3‘) to send text-based command sequences to the SMW ARB application. For example, use the APPL command „STOP_ARB_AND_SET_ARB_PARAMS:”.
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 Using a python script for waveform data transfer Seq. No. Command / frame Description (2,1) APPL command (CmdCode= ‚3‘): Stops the ARB generator, configures waveform parameter. Replies with ACK/NAK. "STOP_ARB_AND_SET_ARB_PARAMS:" If errors occur, repeat this command.
Page 46
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 Using a python script for waveform data transfer Example: To transfer waveform data # General, network and port specfications import socket import ctypes, sys from ctypes import * UDP_IP_CLIENT = "192.168.180.9" UDP_IP_ADDRESS = "192.168.180.14"...
Page 47
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 Using a python script for waveform data transfer def wrtApplCmdAndReadAck(clientSock, frm_cnt, applCmdStr): toSend = len(applCmdStr)+1 # max string length is 4095 addStaffing = toSend % 8 if addStaffing>0: toSend += 8 - addStaffing applCmd = txFrm_t(frm_cnt,0,0x03,toSend,0x0100) applCmd.payload[:len(applCmdStr)] = bytearray(applCmdStr,"ascii")
Page 48
® I/Q over Ethernet (QSFP+) protocol R&S SMM-K507 Using a python script for waveform data transfer clientSock.sendto(bytearray(ctrlFrm)[:8+8], (UDP_IP_ADDRESS, UDP_PORT_NO)) ackFrm = readAck(clientSock) print('Session-Open-Cmd-result: ' , ackFrm.frm_err) # send Send-WV-Config/Header-Cmd: ackFrm = wrtApplCmdAndReadAck(clientSock, 0, strCmdWvConfig + sHdr) print('Send_WV-Header-Ack-result: ' , ackFrm.frm_err)
Need help?
Do you have a question about the SMM-K507 and is the answer not in the manual?
Questions and answers