manualshive.com logo in svg

SIGNALCORE SC5412A, Operating And Programming Manual, Page: 15 / 30

Share
Download
SIGNALCORE SC5412A Operating And Programming Manual Download Page 15

SC5412A Operating & Programming Manual 

Rev 1.1.0 

12 

 

S C 5 4 1 2 A

 

P

R O G R A M M I N G  

I

N T E R F A C E

 

Device Drivers 

The  SC5412A  is  programmed  by  writing  to  its  set  of  configuration  registers,  and  its  data  is  read  back 
through  its  set  of  query  registers.  The  user  may  program  directly  at  register  level  or  through  the  API 
library  functions  provided.  These  API  library  functions  are  wrapper  functions  of  the  registers  that 
simplify the task of configuring the register bytes. The register specifics are covered in the next section. 
Writing  to  and  reading  from  the  device  at  the  register  level  through  the  API  involves  calls  to  the 

sc5412a_RegWrite

 and 

sc5412a_RegRead

 functions respectively. 

The  SC5412A  is  programmed  by  writing  to  its  set  of  configuration  registers,  and  its  status  read  back 
through its set of query registers. The user may choose to program directly at register level or through 
the API library functions provided. These API library functions are wrapper functions of the registers that 
simplify  the  task  of  configuring  of  the  register  bytes.  The  register  specifics  are  covered  in  the  next 
section. Writing to and reading from the device at the register level through the API involves calls to the 

sc5412a_RegWrite

 and 

sc5412a_RegRead

 functions respectively. 

For Microsoft Windows

TM

 operating systems, The SC5412A API is provided as a dynamic linked library, 

sc5412a.dll

. This API uses 

NI-VISA

TM

 to communicate with the device. Inclusion of the NI-VISA driver is 

required  for code  development  in  programming  languages  such  C,  C++,  or  LabVIEW

TM

.  For LabVIEW

TM

 

support, an additional LabVIEW API, sc5412a.llb, is also provided. The functions in the LabVIEW API are 
primarily  LabVIEW  VI  wrappers  to  the  standard  API  functions. 

NI-VISA

TM

  is  available  from  National 

Instruments Corporation (

www.ni.com

). 

For other operating systems or VISA implementations such as Agilent VISA, users will need to access the 
device  through  their  own  proprietary  PXIe  driver.  The  VISA-based  driver  code  is  available  to  our 
customers  by  request.  This  code  can  be  compiled  with  Agilent  VISA  with  minimal  or  no  code  change. 
Should the user require assistance in writing an appropriate API other than that provided, please contact 
SignalCore for additional example code and hardware details. 

Using the Application Programming Interface (API) 

The SC5412A API library functions make it easy for the user to communicate with the device. Using the 
API  removes  the  need  to  understand  register-level  details  -  their  configuration,  address,  data  format, 
etc.,  and  the  additional  layer  between  the PXIe  bridge  and  the  onboard  microcontroller  that  must  be 
configured  prior  to  writing  the  device  registers.  Using  the  API,  commands  to  control  the  device  are 
greatly  simplified.  For  example,  to  obtain  the  device  temperature,  the  user  simply  calls  the  function 

sc5412a_GetDeviceTemperature

,  or  calls 

sc5412a_SetFrequency

  to  tune  the  frequency.  The  software 

API is covered in detail in the “

Software API Library Functions

” section.

 

Summary of Contents for SC5412A

Page 1: ...SC5412A 400 MHz to 6 GHz IQ Modulator PXI Express Interface Operating and Programming Manual 2013 2020 SignalCore Inc support signalcore com ...

Page 2: ...ng Up and Configuring the SC5412A 4 RF Signal Connections 6 Baseband Connections 7 Indicator LED 7 SC5412A Theory of Operation Overview 8 IF Input Section 8 RF Output Section 9 LO Input Section 11 SC5412A Programming Interface Device Drivers 12 Using the Application Programming Interface API 12 Setting the SC5412A Writing to Configuration Registers Configuration Registers 13 Initializing the Devic...

Page 3: ... of the IQ Modulator 15 Storing the Startup State 15 Writing to the User EEPROM 15 Querying the SC5412A Writing to Request Registers Reading the Device Temperature 16 Reading the Device Status 16 Reading the User EEPROM 17 Reading the Calibration EEPROM 17 Calibration EEPROM Map 18 Software API Library Functions Constants Definitions 20 Type Definitions 21 Function Definitions and Usage 21 Calibra...

Page 4: ...ART OF SIGNALCORE INCORPORATED SHALL BE LIMITED TO THE AMOUNT THERETOFORE PAID BY THE CUSTOMER SIGNALCORE INCORPORATED WILL NOT BE LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA PROFITS USE OF PRODUCTS OR INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF ADVISED OF THE POSSIBILITY THEREOF This limitation of the liability of SignalCore Incorporated will apply regardless of the form of action whether in c...

Page 5: ...d the categorical amount present in our products are shown below 組成名稱 Model Name 鉛 Lead Pb 汞 Mercury Hg 镉 Cadmium Cd 六价铬 Hexavalent Chromium Cr VI 多溴联苯 Polybrominated biphenyls PBB 多溴二苯醚 Polybrominated diphenyl ethers PBDE SC5412A A indicates that the hazardous substance contained in all of the homogeneous materials for this product is below the limit requirement in SJ T11363 2006 An X indicates t...

Page 6: ...R SOFTWARE UNANTICIPATED USES OR MISUSES OR ERRORS ON THE PART OF THE USER OR APPLICATIONS DESIGNER ADVERSE FACTORS SUCH AS THESE ARE HEREAFTER COLLECTIVELY TERMED SYSTEM FAILURES ANY APPLICATION WHERE A SYSTEM FAILURE WOULD CREATE A RISK OF HARM TO PROPERTY OR PERSONS INCLUDING THE RISK OF BODILY INJURY AND DEATH SHOULD NOT BE SOLELY RELIANT UPON ANY ONE COMPONENT DUE TO THE RISK OF SYSTEM FAILUR...

Page 7: ... of your Shipment Verify that your SC5412A kit contains the following items Quantity Item 1 SC5412A IQ Modulator 1 USB Flash Drive Installation Software may be combined with other products onto a single drive 1 Getting Started Guide Setting Up and Configuring the SC5412A The SC5412A is a designed for use in a PXIe or PXIe hybrid chassis Chassis manufacturers must provide at least the minimum requi...

Page 8: ...412A is a PXIe based IQ modulator with all I O connections and indicators located on the front face of the module as shown below Each location is discussed in further detail below Figure 1 PXIe chassis view of the SC5412A Module is shown installed in slot 2 ...

Page 9: ...ted Excess liquid alcohol trapped inside the connector may take several days to fully evaporate and may degrade measurement performance until fully evaporated Tighten all SMA connections to 5 in lb max 56 N cm max RF Signal Connections LO OUT This port outputs the tunable LO signal allowing phase coherent daisy chaining of multiple IQ modulator modules The connector is SMA female The nominal outpu...

Page 10: ...on it is recommended to terminate the other half of the differential pair using a 50 Ω terminator All baseband connectors are MCX female Indicator LED The SC5412A provides visual indication of important modes There is one LED indicator on the unit Its behavior under different operating conditions is shown in Table 1 Table 1 LED indicator states LED Color Definition STATUS Green Power good and devi...

Page 11: ... about to overcome A large DC offset will lead to high LO leakage so unless the DC points of the differential inputs are bias the same AC coupling is recommended for single end operation For differential DC coupled input it is recommended to drive the common mode input voltage between 1 5 V to 2 5 V for best linearity performance See Figure 2 for details of the input section From Figure 3 the IF s...

Page 12: ...neral rule is to apply more attenuation earlier in the RF path close to the IQ core to improve linearity and more gain to improve signal to noise performance Generally for RF frequencies less than 3 GHz to vary signal levels greater than 20dBm the attenuators RF ATTEN 1 and RF ATTEN 2 should be used as controls To lower signal levels below 20 dBm ATTEN 3 and ATTEN 4 should then be used Although al...

Page 13: ...Selectable RF Filters 9 Selectable LO Filters LO Amp 2 LO Amp 1 RF Atten 1 RF Atten 4 RF Atten 3 RF Atten 2 Vocm Linear Adjust DAC DC Offset DAC IQ MOD I 2 5V Ref i in i in 5V Ref Vocm Vocm Diff Drive Amp RF Amp 2 RF RF Aux LO LO Aux IF I IF Q Figure 3 Simplified SC5412A block diagram ...

Page 14: ...500 MHz 2 650 MHz 3 1000 MHz 4 1400 MHz 5 2000 MHz 6 2825 MHz 7 3800 MHz 8 6000 MHz LO Input Section The SC5412A requires an external RF signal as its Local Oscillator LO for the frequency conversion process The external RF signal must be connected to the LO in port The typical required input level is 3 dBm to 3 dBm These levels are required to sufficiently drive the IQ modulator for good linearit...

Page 15: ...This API uses NI VISATM to communicate with the device Inclusion of the NI VISA driver is required for code development in programming languages such C C or LabVIEWTM For LabVIEWTM support an additional LabVIEW API sc5412a llb is also provided The functions in the LabVIEW API are primarily LabVIEW VI wrappers to the standard API functions NI VISATM is available from National Instruments Corporatio...

Page 16: ... Address Reg Code Serial Range MSB Bit 7 MSB Bit 6 MSB Bit 5 MSB Bit 4 MSB Bit 3 MSB Bit 2 MSB Bit 1 MSB Bit 0 INITIALIZE 0x01 7 0 Mode SET_SYSTEM_ACTIVE 0x02 7 0 Enable SYS LED RF_FREQUENCY 0x10 7 0 MHz Frequency Word 7 0 15 8 MHz Frequency Word 15 8 23 16 MHz Frequency Word 23 16 31 24 MHz Frequency Word 31 24 39 32 MHz Frequency Word 39 32 RF_AMPLIFIER 0x12 7 0 Amplifier Mode RF_ATTENUATION 0x1...

Page 17: ...et up the filters appropriately Data is sent as a 40 bit word with the LSB in Hz Setting RF Input RF Amplifiers RF_AMPLIFIER 0x12 This register enables or disables the RF amplifiers Setting bit 0 low 0 disables RF amplifier Setting bit 0 high 1 enables RF amplifier Setting the RF Attenuation RF_ATTENUATION 0x13 Each of the attenuators is a 5 bit digital step attenuator with 1 dB per LSB Data is se...

Page 18: ... Linearity of the IQ Modulator LINEARITY_DAC 0x19 This DAC controls the bias point of the IQ modulator A typical value for the bias point is 1 2V however adjustments are needed to improve linearity at different operating frequency and input IF power levels Typically the DAC is set around 1 2 V using the following equation 𝐷𝐴𝐶 𝑉𝑎𝑙𝑢𝑒 16383 𝑉 𝑐𝑜𝑚 5𝑉 Storing the Startup State STORE_STARTUP_STATE 0x1D ...

Page 19: ...first 14 bits 13 0 Bit 13 is the polarity bit indicating whether it is positive 0x0 or negative 0x1 For an ENDPOINT_IN transfer data is returned in 2 bytes with the MSB first The temperature value represented in the raw data is contained in the next 13 bits 12 0 To obtain the temperature ADC code the raw data should be masked bitwise AND ed with 0x1FFF and the polarity should be masked with 0x2000...

Page 20: ... 0x8000 will return data stored in address location 0x0000 The calibration EEPROM map is shown in Table 5 All calibration data whether floats unsigned 8 bit unsigned 16 bit or unsigned 32 bit integers are stored as flattened unsigned byte representation A float is flattened to 4 unsigned bytes so once it is read back it needs to be un flattened back to its original type Unsigned values containing ...

Page 21: ...OM map EEPROM ADDRESS HEX NUMBER OF DATA POINTS TYPE DESCRIPTION 0 1 U32 Manufacturing information 4 1 U32 Product serial number 8 1 U32 RF module number C 1 U32 Product manufacture date 24 1 F32 Firmware revision 28 1 F32 Hardware revision 2C 40 F32 Reserved CF 33 U8 Startup state F4 1 F32 Calibration temperature ...

Page 22: ...nitDevice sc5412a_SetFrequency sc5412a_SetRfGain sc5412a_SetRfAmplifier sc5412a_SetRfPath sc5412a_SetLoOut sc5412a_SetRfAttenuation sc5412a_SetRfFilter sc5412a_SetLoFilter sc5412a_SetIfGainDac sc5412a_SetVcomDac sc5412a_SetDcOffsetDac sc5412a_SetLinearityDac sc5412a_WriteUserEeprom sc5412a_StoreCurrentState sc5412a_GetDeviceInfo sc5412a_GetDeviceStatus sc5412a_GetTemperature sc5412a_ReadCalEeprom ...

Page 23: ...x01 initialize the device define SET_SYSTEM_ACTIVE 0x02 set the device active LED define RF_FREQUENCY 0x10 set the frequency define RF_AMPLIFIER 0x12 enable amplifiers define RF_ATTENUATION 0x13 set attenuation for digital step attenuators define RF_PATH 0x14 select the RF path define RF_FILTER_SELECT 0x15 manually select the RF filter define LO_FILTER_SELECT 0x16 manually select the LO filter def...

Page 24: ...assist with understanding the input and output parameters Function sc5412a_ListResources Definition int sc5412a_ListResources char visaResource unsigned int size Output char visaResource pointer list to device resources Description sc5412a_ListResources searches for SignalCore SC5412A devices connected to the host computer and return an array containing their unique VISA resource ID This informati...

Page 25: ...er specified by the commandByte See the register map on Table 2 for more information Example To set the frequency to 2 GHz int status sc5412a_RegWrite devHandle RF_FREQUENCY 2000000000 set frequency to 2 GHz Declaring char visaResource char malloc sizeof char 10 10 devices unsigned int deviceHandle int devicesFound int i status Allocate memory for 10 device with 20 characters to hold ID for i 0 i ...

Page 26: ... Mode 0 resets the device to the default power up state Mode 1 resets the device but leaves it in its current state Function sc5412a_SetFrequency Definition int sc5412a_SetFrequency unsigned int deviceHandle unsigned long long int frequency Input unsigned int deviceHandle handle to the opened device unsigned long long int frequency frequency in Hz Description sc5412a_SetFrequency sets the RF frequ...

Page 27: ... unsigned int deviceHandle unsigned char filter Input unsigned int deviceHandle handle to the opened device unsigned char filter select the appropriate filter number 0 8 Description sc5412a_SetRfFilter selects the active filter in the RF filter bank Function sc5412a_SetLoFilter Definition int sc5412a_SetLoFilter unsigned int deviceHandle unsigned char filter Input unsigned int deviceHandle handle ...

Page 28: ...ar byteData Input unsigned int deviceHandle handle to the opened device unsigned int memAdd memory address to write to unsigned char byteData byte to be written to the address Description sc5412a_WriteUserEeprom writes one byte of data to the memory address specified Function sc5412a_StoreCurrentState Definition int sc5412a_StoreCurrentState unsigned int deviceHandle Input unsigned int deviceHandl...

Page 29: ...n int sc5412a_ReadCalEeprom unsigned int deviceHandle unsigned int memAdd unsigned char byteData Input unsigned int deviceHandle handle to the opened device unsigned int memAdd EEPROM memory address Output unsigned char byteData the read back byte data Description sc5412a_ReadUserEeprom reads back a byte from a specific memory address of the calibration EEPROM Function sc5412a_ReadUserEeprom Defin...

Page 30: ...ation The SC5412A is sold as a component and users will need to perform amplitude and IQ correction as part of their system which may minimally include a digitizer LO source and the SC5412A Should users require SignalCore to perform any calibration please contact SignalCore support directly ...

Reviews:

No comments