Differences

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

--- atmos:software:accessing.adpaa:home [2026/06/12 17:27] – 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"
   - After this, run the command "sudo apt upgrade" to make sure the computer is updated and every package installed.
-  - Additionally, run the command sudo "apt-get install subversion", otherwise, you'll run into some issues later.
+  - Additionally, run the command "sudo apt-get install subversion", otherwise, you'll run into some issues later.
-  - Once it has finished, open the file, "Share" and select the text files entitled "INSTALL" and "adpaa bashrc"
+  - Once it has finished, open the folder, "share" and select the text files entitled "INSTALL" and "bashrc-adpaa"
-  - Open the "adpaa bashrc" file and scroll to find text that will say
+  - Open the "bashrc-adpaa" file and scroll to find text that will say
-    PATH=/home/pi/ADPAA/bin:${PATH}
+    PATH=${ADPAA_DIR}/bin:${PATH}
-    PYTHONPATH=/home/pi/ADPAA/bin:${PYTHONPATH}
+    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: "pi" may be different, the text is the absolute path to the ADPAA/bin directory.
+  - 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.
-  - Follow the instructions in the ADPAA INSTALL file very carefully. Do not skip any steps or think that you may disregard them.
+  - Type the command "source ~/.bashrc"
-  - 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.
+  - 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. Then, you can delete the "adpaa-code" file.
+  - 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 may have to use the command "sudo rm -r adpaa-code" to delete it.
+  - You will also have to do this in the directory /usr/local/ADPAA
-    - 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"
-      - 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.
-      - then, "sudo rm -r /usr/local/ADPAA/adpaa-code"
+  - After the "pip3 install..." command section, return to your home directory and enter the command "adpaa setup"
-    - 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.
+    - 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: