Differences

This shows you the differences between two versions of the page.

--- atmos:software:accessing.adpaa:home [2025/11/25 03:26] – ashley.vos
+++ atmos:software:accessing.adpaa:home [2026/06/12 17:40] (current) – ashley.vos
@@ Line 29: / Line 29: @@
 Typically, this is only done on measurement devices to allow access to the code created for data acquisition, such as a Raspberry Pi.
+Please skim through the instructions and read the troubleshooting section before beginning. It will likely save you some frustration.
 After downloading the ADPAA onto your Raspberry Pi from the link above, you will find it in your "Downloads" folder.
+  - In your home directory, create two folders: "ADPAA" and "CoPAS".
+  - Move the downloaded ADPAA.tar.gz from the "Downloads" folder to the "ADPAA" folder.
   - Right click on the file (ADPAA.tar.gz) and select "Extract Here"
-  - Once it has finished, open the file, "Share" and select the text file entitled "INSTALL"
+  - After this, run the command "sudo apt upgrade" to make sure the computer is updated and every package installed.
-  - Follow the instructions in the ADPAA INSTALL file very carefully. Do not skip any steps or think that you may disregard them.
+  - Additionally, run the command "sudo apt-get install subversion", otherwise, you'll run into some issues later.
-  - The very first step is to create an APDAA directory. Once you have done so, move all the files from the ADPAA from downloads to this directory, which will appear as a folder under your Raspberry Pi Home directory.
+  - Once it has finished, open the folder, "share" and select the text files entitled "INSTALL" and "bashrc-adpaa"
-  - You will want to complete the "Setting up Python3 for ADPAA Distribution" before either "System-wide Source Code Download of Package (Read Access)" or "Developer Version Source Code Download of Package (Read/Write Access)."
+  - Open the "bashrc-adpaa" file and scroll to find text that will say
+    PATH=${ADPAA_DIR}/bin:${PATH}
+    PYTHONPATH=${ADPAA_DIR}/bin:${PYTHONPATH}
+  - Using the terminal, type the command "sudo nano ~/.bashrc", then scroll to the bottom of the file and enter the above text.
+    - Note: Replace ${ADPAA_DIR} with the absolute path to the ADPAA/bin directory. It should be /home/pi/ADPAA/bin, unless your Raspberry Pi is not named "pi"
+  - In addition, add the following text as well.
+    PATH=/home/pi/CoPAS/ADPAA/bin:${PATH}
+    PYTHONPATH=/home/pi/CoPAS/ADPAA/bin:${PYTHONPATH}
+  - Save the file and exit.
+  - Type the command "source ~/.bashrc"
+  - Open the ADPAA INSTALL file and follow the instructions very carefully. Do not skip any steps or think that you may disregard them.
+  - After you complete the "Developer Version Source Code Download of Package (Read Access)" step, enter your file tree and copy the folder titled "src" out of the folder titled "adpaa-code" and into your main "ADPAA" folder.
+  - You will also have to do this in the directory /usr/local/ADPAA
+    - use the command "sudo cp -r /usr/local/ADPAA/adpaa-code/src /usr/local/ADPAA"
+  - When doing the "Setting up Python3 for ADPAA Distribution" step, you will have to add "- - break-system-packages" to the end of the "pip3 install..." command.
+  - After the "pip3 install..." command section, return to your home directory and enter the command "adpaa setup"
+    - If you've done everything correctly up to this point, the terminal will tell you to run the command "source ~/.bashrc"
+    - If not, go back and find out where an error occurred.
+  - Finally, follow the instruction in the ADPAA INSTALL file to run the "make && make -f Makefile_osa" command
 Trouble Shooting:
   * You will likely encounter an error that says "Permission denied" or something similar along the way. If this occurs, try adding the root command "sudo" to the beginning of the line. If that doesn't work, the program will tell you, and you can try "sudo apt" in cases where you are installing or downloading something.
+  * When following the INSTALL instructions, when it says "${ADPAA_DIR}" or similar, you should use "~/ADPAA" instead if it doesn't work.