This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
resources:eval:user-guides:circuits-from-the-lab:cn0566:quickstart [20 Apr 2023 16:45] – Link to 2021_r2 image. WooHoo! Mark Thoren | resources:eval:user-guides:circuits-from-the-lab:cn0566:quickstart [03 Apr 2024 01:29] (current) – Fix HB100 power supply voltage / cell count Mark Thoren | ||
---|---|---|---|
Line 7: | Line 7: | ||
- | ===== Videos | + | ===== Unboxing / Setup Video ===== |
<WRAP centeralign> | <WRAP centeralign> | ||
- | {{youtube> | + | {{youtube> |
- | \\ | + | |
- | **(The Phaser comes mostly assembled. Start at around 12:45, after it's been completely assembled.) ** | + | |
</ | </ | ||
Line 23: | Line 21: | ||
* 5 V, 3 A, USB-C wall adapter | * 5 V, 3 A, USB-C wall adapter | ||
* HB100 microwave source | * HB100 microwave source | ||
- | * 3V benchtop supply or 2 AA cells for HB100 power | + | * 5V benchtop supply or 3 AAA (or AA) cells for HB100 power |
* Micro HDMI to HDMI cable (or suitable adapters) | * Micro HDMI to HDMI cable (or suitable adapters) | ||
* 16GB or larger SD card | * 16GB or larger SD card | ||
- | * USB keyboard and mouse | ||
- | * Monitor with HDMI display | ||
* Tripod | * Tripod | ||
+ | * One of the following: | ||
+ | * Ethernet cable and DHCP-enabled network with internet access | ||
+ | * Wireless network | ||
+ | * One of the following: | ||
+ | * USB keyboard and mouse, HDMI display (if running locally) | ||
+ | * Host computer with SSH client and / or VNC client. | ||
* **Software** | * **Software** | ||
* ADI Kuiper Linux image | * ADI Kuiper Linux image | ||
Line 34: | Line 36: | ||
* Wired or Wireless network connection, with access to the internet (for accessing update files from Github.) | * Wired or Wireless network connection, with access to the internet (for accessing update files from Github.) | ||
\\ | \\ | ||
+ | <WRAP lo round download 80%> | ||
+ | This is the step file for the HB100 holder, with a 1/4-20 thread for a standard camera mount. HB100s can vary from manufacturer to manufacturer, | ||
+ | \\ | ||
+ | Alternatively, | ||
+ | \\ | ||
+ | **{{ : | ||
+ | </ | ||
---- | ---- | ||
Line 45: | Line 54: | ||
</ | </ | ||
\\ | \\ | ||
- | |||
- | \\ | ||
- | |||
---- | ---- | ||
===== SD card / Software Setup ===== | ===== SD card / Software Setup ===== | ||
- | **The SD card that ships with the first phaser production run MUST be updated with a new image.**\\ | + | **The SD card that ships with the first phaser production run MUST be updated with a new image.** |
- | In order to control the CN0566 from the Raspberry Pi, you will need to install ADI Kuiper Linux on an SD card. A summary of the minim steps follows, while complete instructions, including where to download | + | |
- | + | ||
- | <WRAP todo> | + | |
- | Kuiper 2021_r2 is not documented at **[[: | + | |
- | **[[https:// | + | |
\\ | \\ | ||
- | </ | + | In order for the Raspberry Pi to control |
- | + | ||
- | Pay particular attention | + | |
\\ | \\ | ||
- | Download the Kuiper Linux SD card image and unzip it to a convenient location, and write the image to the SD card. The Kuiper Linux wiki pages give a few options, but the " | + | **Hints: |
**[[https:// | **[[https:// | ||
\\ | \\ | ||
Line 70: | Line 69: | ||
</ | </ | ||
- | After burning, if a window pops up saying "this card needs to be formatted, would you like to format it now?", the answer is **NO.** Eject the card and insert it into the Raspberry Pi's SD card slot. | + | After writing the image, if a window pops up saying "this card needs to be formatted, would you like to format it now?", the answer is **NO.** Eject the card and insert it into the Raspberry Pi's SD card slot. |
===== Assembling, Booting and Configuring the System ===== | ===== Assembling, Booting and Configuring the System ===== | ||
{{ : | {{ : | ||
<wrap center 50%> | <wrap center 50%> | ||
- | //<fc #c0c0c0>Figure 3. Test Setup Functional Block Diagram</ | + | Figure 3. Test Setup Functional Block Diagram |
</ | </ | ||
- Connect ADALM-Pluto' | - Connect ADALM-Pluto' | ||
- **CAREFULLY** thread the tripod into the tripod mount. Please minmize stress on the tripod mount while plugging in cables and other operations, as it is screwed directly to the PC board. | - **CAREFULLY** thread the tripod into the tripod mount. Please minmize stress on the tripod mount while plugging in cables and other operations, as it is screwed directly to the PC board. | ||
- | - Connect | + | - Verify that the SD card is properly inserted into the slot on the Raspberry Pi. |
- | - Connect | + | |
- | - Verify that the burned SD card is properly inserted into the slot on the Raspberry Pi. | + | |
+ | - For remote login, connect | ||
- Power up the setup through the type-C port of the CN0566. Do NOT connect a supply to the Raspberry Pi. | - Power up the setup through the type-C port of the CN0566. Do NOT connect a supply to the Raspberry Pi. | ||
- | - Wait for Raspberry Pi to boot. Upon booting, open a terminal as seen on the taskbar. | + | - Wait for Raspberry Pi to boot. (This may take a minute or two, as the filesystem is expanded on first boot.) |
- | - Configure | + | - After booting, |
- | - Make sure to reboot the Raspberry Pi after saving the // | + | |
- | - Wait for the Raspberry Pi to boot up again. | + | |
- | \\ | ||
---- | ---- | ||
- | |||
==== Configuring the SD Card ==== | ==== Configuring the SD Card ==== | ||
- | + | The easiest way to configure | |
- | + | Once connected to a network, run the following commands (and take a look at the setup script if you're suspicious, and note that there may be some updates as newer versions of Kuiper Linux are released.) | |
- | After burning | + | |
- | Set the hostname | + | |
- | Next, run the following commands (and take a look at the setup script if you're suspicious, and note that there may be some updates as newer versions of Kuiper Linux are released.) | + | |
< | < | ||
wget https:// | wget https:// | ||
Line 105: | Line 97: | ||
sudo reboot | sudo reboot | ||
</ | </ | ||
- | (Wait for the system to reboot) | + | (Wait for the system to reboot)\\ |
+ | **Note:** After running the script, the hostname will be **phaser.local** | ||
+ | \\ | ||
+ | If you are going to be running scripts and other software directly on the Raspberry Pi, it's a good idea set a few options using the Raspberry Pi configuration utility. This can be accessed from the Start Menu under Preferences, | ||
+ | < | ||
+ | sudo raspi-config | ||
+ | </ | ||
+ | from the command line. Set the locale, keyboard, timezone, and wifi country (if you'll be connecting to your network by wifi.) | ||
+ | \\ | ||
==== Software Quick Start ==== | ==== Software Quick Start ==== | ||
Line 111: | Line 112: | ||
At this point, the GUI can be run from the command line. Power up the HB100 source with either a 3V benchtop power supply or two AA cells and aim it a the phaser antenna. Run the following command to find the HB100 frequency: | At this point, the GUI can be run from the command line. Power up the HB100 source with either a 3V benchtop power supply or two AA cells and aim it a the phaser antenna. Run the following command to find the HB100 frequency: | ||
< | < | ||
- | python | + | cd ~/ |
+ | python | ||
</ | </ | ||
Line 124: | Line 126: | ||
< | < | ||
- | cd ~/ | + | cd ~/ |
- | python | + | python |
</ | </ | ||
The GUI should load and begin displaying the beam pattern as shown below. | The GUI should load and begin displaying the beam pattern as shown below. | ||
Line 134: | Line 136: | ||
==== Initial Calibration ==== | ==== Initial Calibration ==== | ||
- | The phaser board is initially uncalibrated; | + | The phaser board is initially uncalibrated; |
< | < | ||
- | python3 cn0566_examples.py cal | + | cd ~/ |
+ | python phaser_examples.py cal | ||
</ | </ | ||
- | The script provides debug information and plots as it is running, you may have to close out of each plot for the script to proceed. After running this script, files gain_cal_val.pkl and phase_cal_val.pkl will be placed in the working directory. The GUI program will also load these files automatically. | + | The script provides debug information and plots as it is running, you may have to close out of each plot for the script to proceed. After running this script, files gain_cal_val.pkl and phase_cal_val.pkl will be placed in the working directory. The GUI program will also load these files automatically |
Refer to **[[resources: | Refer to **[[resources: | ||
Line 148: | Line 151: | ||
===== Appendix: Pluto Setup ===== | ===== Appendix: Pluto Setup ===== | ||
- | The Pluto that ships with the phaser kit has been pre-configured. In case something goes wrong, here is how to update the firmware and settings. | + | The Pluto that ships with the phaser kit has been pre-configured. In case something goes wrong, here is how to update the firmware and settings. |
- | A Pluto Rev C or higher is required. For the CN0566, a custom firmware image is used that incorporates a TDD engine and additional control signals. | + | **[[repo> |
- | + | ||
- | <WRAP todo> | + | |
- | REMOVE this when it's got a proper home on Github releases\\ | + | |
- | The first step is to update the firmware to the latest release, following the procedure at:\ | + | |
- | [[https:// | + | |
- | Next, download and unzip the updated firmware image, located here:\\ | + | |
- | {{ : | + | |
- | + | ||
- | (**Yes**, unzip, UNlike upgrading to the latest release.)\\ | + | |
- | Drag and drop the pluto_DW_feb_7_2022.frm to the Pluto mass storage device, then eject.\\ | + | |
- | \\ | + | |
- | For Reference - OLD version (do NOT use):\\ | + | |
- | {{ : | + | |
- | {{ : | + | |
- | </ | + | |
The next step is to update the Pluto configuration to enable the AD9361' | The next step is to update the Pluto configuration to enable the AD9361' | ||
Line 194: | Line 182: | ||
===== Appendix: Configuration Script Notes ===== | ===== Appendix: Configuration Script Notes ===== | ||
- | A complete config.txt file is posted for convenience. Enter the following commands from a terminal to download and apply a complete config.txt file with all edits above included: | + | |
- | < | + | |
- | wget https:// | + | |
- | rename config_phaser.txt config.txt | + | |
- | sudo mv / | + | |
- | sudo cp config.txt /boot/ | + | |
- | </ | + | |
- | \\ | + | |
<WRAP tip> | <WRAP tip> | ||
- | Or alternatively, follow the Hardware Configuration procedure under **Preparing the Image: Raspberry Pi** in the [[: | + | To manually edit config.txt, add the following: |
\\ | \\ | ||
< | < | ||
Line 217: | Line 198: | ||
</ | </ | ||
- | If you will be logging in via VNC, comment out the following line, and set the HDMI group and mode accordingly: | + | If you will be logging in via VNC, see this article: |
+ | **[[https:// | ||
+ | Also if running " | ||
< | < | ||
# dtoverlay=vc4-kms-v3d | # dtoverlay=vc4-kms-v3d | ||
Line 226: | Line 209: | ||
</ | </ | ||
</ | </ | ||
- | |||
- | \\ | ||
- | <WRAP todo> | ||
- | REMOVE this when merged:\\ | ||
- | For now - the CN0566 GUI and required pyadi-iio additions are in a development branch. The pyadi-iio that is pre-installed on Kuiper needs to be cleanly removed and replaced. Run the following commands: | ||
- | < | ||
- | cd ~ | ||
- | # Uninstall existing pyadi, reinstall from source: | ||
- | sudo pip3 uninstall -y pyadi-iio | ||
- | git clone https:// | ||
- | cd pyadi-iio | ||
- | git checkout cn0566_dev | ||
- | sudo python3 setup.py install | ||
- | </ | ||
- | </ | ||
- | |||
//End of Document// | //End of Document// |