This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | Next revisionBoth sides next revision | ||
resources:eval:user-guides:circuits-from-the-lab:cn0566:quickstart [27 Apr 2023 16:33] – [Initial Calibration] Jon Kraft | resources:eval:user-guides:circuits-from-the-lab:cn0566:quickstart [29 Apr 2023 00:03] – More cleanup. Mark Thoren | ||
---|---|---|---|
Line 26: | Line 26: | ||
* 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 45: | Line 49: | ||
</ | </ | ||
\\ | \\ | ||
- | |||
- | \\ | ||
- | |||
---- | ---- | ||
===== 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 64: | ||
</ | </ | ||
- | 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 92: | ||
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 135: | Line 131: | ||
==== Initial Calibration ==== | ==== Initial Calibration ==== | ||
- | The phaser board is initially uncalibrated; | + | The phaser board is initially uncalibrated; |
< | < | ||
cd ~/ | cd ~/ | ||
python phaser_examples.py cal | 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 196: | Line 192: | ||
===== 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 239: | Line 228: | ||
git clone https:// | git clone https:// | ||
cd pyadi-iio | cd pyadi-iio | ||
- | git checkout | + | git checkout |
- | sudo python3 setup.py | + | sudo pip install |
</ | </ | ||
</ | </ |