Skip to content

Latest commit

 

History

History
118 lines (85 loc) · 5.11 KB

readme.md

File metadata and controls

118 lines (85 loc) · 5.11 KB
Raw

S3 Flight Software

How to install the Arduino IDE on Windows

  1. Download Arduino IDE from here
  2. TBD - need to add "how to download + run arduino IDE" detail for Windows Version
  3. If on Windows, you will need to install a driver to connect to the board:
    • Open this link in a browser
    • Click "adafruit_drivers_X.X.X.X.exe" to download it
    • Double-click "adafruit_drivers_X.X.X.X.exe"
    • Click "I Agree", "Next", "Close" to get the driver installed

How to install the Arduino IDE on Linux

  1. Download Arduino IDE from here

  2. Choose "Linux AppImage 64 bits (X86-64)"

  3. The file "arduino-ide_2.1.1_Linux_64bit.AppImage" will be saved to your Downloads folder

  4. Run these commands in a terminal

     cd ~/Downloads/
 chmod +x arduino-ide_*
 ./arduino-ide_*

  5. The Arduino IDE should open

  6. Click "File->Preferences"

  7. Paste the following into the "Additional Board URLs" textbox:

     https://adafruit.github.io/arduino-board-index/package_adafruit_index.json

  8. Click "Ok" to close the Preferences window

  9. Click "Tools -> Board -> Boards Manager"

  10. Search for "Arduino SAMD Boards" and click "Install"

  11. Wait a few minutes for the installation to complete

  12. Next, search for "Adafruit SAMD Boards" and click "Install"

  13. Wait a few minutes for the installation to complete

  14. Reopen the Arduino IDE

    • Click "File -> Quit"

    • Run these commands in a terminal

      cd ~/Downloads/
chmod +x arduino-ide_*
./arduino-ide_*

  15. Select "Tools -> Board -> Adafruit SAMD boards -> Adafruit ItsyBitsy M4 (SAMD51)"

  16. Done with setup! Continue to a different section.

How to get the latest Quest software on Linux

  1. Go to the Flight SW repository release page (link)

  2. Download the latest "Source code (zip)"

  3. Unzip the folder

     cd ~/Downloads
 unzip 0.0.1.zip

  4. Inside, you will find a "libraries" folder

  5. Copy the "libraries" folder

  6. Navigate to "~/Arduino/", delete the "libraries" folder if it exists, and paste the copied "libraries" folder

     rm -r ~/Arduino/libraries
 mkdir -p ~/Arduino/libraries
 cp -r ~/Downloads/0.0.1/libraries ~/Arduino

  7. If you are updating a previously-installed version, you are done. Try building your project's flying.ino file in the Arduino IDE.

  8. If this is your first time downloading the software, follow these steps to get the template flying.ino:

  9. Make a folder somewhere on your PC to hold your project files. In this example, we will use ~/Projects/My_Experiment

  10. Make the folder using a file explorer window, or run this command:

     mkdir -p ~/Projects/My_Experiment

  11. Copy flying.ino and flying.h into your project folder

     cp ~/Downloads/0.0.1/flying.ino ~/Downloads/0.0.1/flying.h ~/Projects/My_Experiment/

  12. Open the Arduino IDE (If you have not installed it yet, see the section for Windows or Linux) first

  13. In the Arduino IDE, select "File -> Open"

  14. Navigate to ~/Projects/My_Experiment/ and double-click flying.ino

  15. Click "Sketch -> Verify/Compile"

  16. Wait a few seconds - the compilation should complete and output a message "Sketch uses XXX bytes of program..."

  17. Move to the next section

Connect to a development board

  1. Open the Arduino IDE (If you have not installed it yet, see the section for Windows or Linux) first

  2. In the Arduino IDE, select "File -> Open"

  3. Navigate to ~/Projects/My_Experiment/ and double-click flying.ino

  4. Connect a development board to your PC using a USB cable

  5. Click "Tools -> Port -> /dev/ttyACM0 (Adafruit ItsyBitsy M4 (SAMD51))"

  6. Click Tools -> Serial Monitor

  7. To the right of the "Message" text box, there is a dropdown menu. If it says "New Line", select "Carrage Return" instead.

  8. Click "Sketch -> Upload" (or press Ctrl+U)

  9. Wait a few seconds for the code to compile and upload.

  10. If all goes well, the serial monitor should output something similar to the following:

     Verify successful
 System Boot Version XX
 Compiled Date => XX
 Source file => XX

 Free Memory = XX HEX or XX DEC
 Input 'T' to enter test within 15 seconds

  11. You can now type a T and hit <Enter> to start test mode. If you don't hit T fast enough, hit the RESET button on the development board to reboot and output the prompt again.

Write your own code for your experiment

  1. Open the Arduino IDE (If you have not installed it yet, see the section for Windows or Linux) first
  2. In the Arduino IDE, select "File -> Open"
  3. Navigate to ~/Projects/My_Experiment/ and double-click flying.ino
  4. Edit the Flying() function in flying.ino with your experiment's custom code
  5. Click "Sketch -> Upload" (or press Ctrl+U)
  6. Your custom code will run