adi.cn0566 module
- class adi.cn0566.CN0566(uri=None, sdr=None, _chip_ids=['BEAM0', 'BEAM1'], _device_map=[[1], [2]], _element_map=[[1, 2, 3, 4, 5, 6, 7, 8]], _device_element_map={1: [7, 8, 5, 6], 2: [3, 4, 1, 2]}, verbose=False)
Bases:
adf4159,adar1000_arrayCN0566 class inherits from adar1000_array and adf4159 and adds operations for beamforming like default configuration, calibration, set_beam_phase_diff, etc. _gpios (as one-bit-adc-dac) are instantiated internally. ad7291 temperature / voltage monitor instantiated internally. CN0566.sdr property is an instance of a Pluto SDR with updated firmware, and updated to 2t2r.
- parameters:
- uri: type=string
URI of Raspberry Pi attached to the phaser board
- verbose: type=boolean
Print extra debug information
- SDR_init(SampleRate, TX_freq, RX_freq, Rx_gain, Tx_gain, buffer_size)
- Initialize Pluto rev C for operation with the phaser. This is a convenience
method that sets several default values, and provides a handle for a few other CN0566 methods that need access (i.e. set_rx_hardwaregain())
parameters
- SampleRate: type=int
ADC/DAC sample rate.
- TX_freq: type=float
Transmit frequency. lo-sdr.TX_freq is what shows up at the TX connector.
- RX_freq: type=float
Receive frequency. lo-sdr.RX_freq is what shows up at RX outputs.
- Rx_gain: type=float
Receive gain. Set indirectly via set_rx_hardwaregain()
- Tx_gain: type=float
Transmit gain, controls TX output amplitude.
- buffer_size: type=int
Receive buffer size
- c = 299792458
speed of light in m/s
- ccal
Gain compensation for the two RX channels in dB. Includes all errors, including the SDRs
- configure(device_mode='rx')
Configure the device/beamformer properties like RAM bypass, Tr source etc.
Parameters
- device_mode: type=string
(“rx”, “tx”, “disabled”, default = “rx”)
- device_mode = 'rx'
For future RX/TX operation. Set to RX.
- element_spacing = 0.015
Element to element spacing of the antenna in meters
- gcal
Per-element gain compensation, AFTER above channel compensation. Use to scale value sent to ADAR1000.
- property lo
Get the VCO output frequency, accounting for the /4 ahead of the ADF4159 RFIN.
- load_channel_cal(filename='channel_cal_val.pkl')
Load channel gain compensation values, if not calibrated set all to 0.
Parameters
- filename: string
Path/name of channel calibration file
- load_gain_cal(filename='gain_cal_val.pkl')
Load gain calibrated value, if not calibrated set all channel gain to maximum.
Parameters
- filename: type=string
Provide path of gain calibration file
- load_phase_cal(filename='phase_cal_val.pkl')
Load phase calibrated value, if not calibrated set all channel phase correction to 0.
Parameters
- filename: type=string
Provide path of phase calibration file
- num_elements = 8
Number of antenna elements
- pcal
Phase calibration array. Add this value to the desired phase. Initialize to zero (no correction).
- phase_step_size = 2.8125
Phase adjustment resolution
- read_monitor(verbose=False)
Read all voltage / temperature monitor channels.
Parameters
- verbose: type=bool
Print each channel’s information if true.
- returns:
An array of all readings in SI units (deg. C, Volts)
- save_channel_cal(filename='channel_cal_val.pkl')
Saves channel calibration file.
- save_gain_cal(filename='gain_cal_val.pkl')
Saves gain calibration file.
- save_phase_cal(filename='phase_cal_val.pkl')
Saves phase calibration file.
- set_all_gain(value=127, apply_cal=True)
Set all channel gains to a single value
Parameters
- value: type=int
gain for all channels. Default value is 127 (maximum).
- apply_cal: type=bool
Optionally apply gain calibration to all channels.
- set_beam_phase_diff(Ph_Diff)
Set phase difference between the adjacent channels of devices
Parameters
- Ph-Diff: type=float
Ph_diff is the phase difference b/w the adjacent channels of devices
Notes
A public method to sweep the phase value from -180 to 180 deg, calculate phase values of all the channel and set them. If we want beam angle at fixed angle you can pass angle value at which you want center lobe
Create an empty list. Based on the device number and channel of that device append phase value to that empty list this creates a list of 4 items. Now write channel of each device, phase values acc to created list values. This is the structural integrity mentioned above.
- set_chan_gain(chan_no: int, gain_val, apply_cal=True)
Setl gain of the individua channel/s.
Parameters
- chan_no: type=int
It is the index of channel whose gain you want to set
- gain_val: type=int or hex
gain_val is the value of gain that you want to set
- apply_cal: type=bool
Optionally apply gain calibration for the selected channel
- set_chan_phase(chan_no: int, phase_val, apply_cal=True)
Setl phase of the individua channel/s.
Parameters
- chan_no: type=int
It is the index of channel whose gain you want to set
- phase_val: float
phase_val is the value of phase that you want to set
- apply_cal: type=bool
Optionally apply phase calibration
Notes
Each device has 4 channels but for top level channel numbers are 1 to 8 so took device number as Quotient of channel num div by 4 and channel of that dev is overall chan num minus 4 x that dev number. For e.g: if you want to set gain of channel at index 5 it is 6th channel or 2nd channel of 2nd device so 5//4 = 1 i.e. index of 2nd device and (5 - 4*(5//4) = 1 i.e. index of channel
- set_rx_hardwaregain(gain, apply_cal=True)
Set Pluto channel gains
Parameters
- gain: type=float
Gain to set both channels to
- apply_cal: type=bool
Optionally apply channel gain correction
- set_tx_sw_div(div_ratio)
Set TX switch toggle divide ratio. Possible values are: 0 (direct TX_OUT control via gpio_tx_sw) divide by 2, 4, 8, 16, 32, 64, 128