|
| 1 | +--- |
| 2 | +title: |
| 3 | +description: |
| 4 | +author: Karl Söderby |
| 5 | +tags: [UNO Q, ADB, Linux] |
| 6 | +--- |
| 7 | + |
| 8 | +## Requirements |
| 9 | + |
| 10 | +The following hardware is required: |
| 11 | +- [Arduino UNO Q](https://store.arduino.cc/products/uno-q) |
| 12 | +- [USB-C® type cable](https://store.arduino.cc/products/usb-cable2in1-type-c) |
| 13 | + |
| 14 | +You will also need to have the following software installed: |
| 15 | +- [Android Debug Bridge](https://developer.android.com/tools/releases/platform-tools) |
| 16 | + |
| 17 | +## Installing ADB (Host Computer) |
| 18 | + |
| 19 | +***Note: if you are using the board as a Single Board Computer (SBC Mode (Preview) without a host computer), you do not need to install ADB. You can run `arduino-app-cli` directly from the terminal.*** |
| 20 | + |
| 21 | +The ADB command line tool is supported on MacOS, Windows & Linux. For more specific instructions for your OS, see the sections below. |
| 22 | + |
| 23 | +***You can find more information and download the latest version for the tool for all operating systems directly from the [Android SDK Platform Tools](https://developer.android.com/tools/releases/platform-tools#downloads) page.*** |
| 24 | + |
| 25 | +### MacOS |
| 26 | + |
| 27 | +To install the ADB tools on **MacOS**, we can use `homebrew`. Open the terminal and run the following command: |
| 28 | + |
| 29 | +```sh |
| 30 | +brew install android-platform-tools |
| 31 | +``` |
| 32 | + |
| 33 | +To verify the tool is installed, run `adb version`. |
| 34 | + |
| 35 | +### Windows |
| 36 | + |
| 37 | +To install the ADB tools on **Windows**, we can use `winget`, supported on Windows 11 and on some earlier Windows 10 versions. |
| 38 | + |
| 39 | +Open a terminal and run the following: |
| 40 | + |
| 41 | +```sh |
| 42 | +winget install Google.PlatformTools |
| 43 | +``` |
| 44 | + |
| 45 | +To verify the tool is installed, run `adb version`. |
| 46 | + |
| 47 | +### Linux |
| 48 | + |
| 49 | +To install ADB tools on a **Debian/Ubuntu Linux distribution**, open a terminal and run the following command: |
| 50 | + |
| 51 | +```sh |
| 52 | +sudo apt-get install android-sdk-platform-tools |
| 53 | +``` |
| 54 | + |
| 55 | +To verify the tool is installed, run `adb version`. |
| 56 | + |
| 57 | +## Connect via ADB |
| 58 | + |
| 59 | +1. Connect the UNO Q board to your computer via USB-C. |
| 60 | +2. Run `adb devices` in the terminal. This should list the connected devices. |
| 61 | + |
| 62 | +  |
| 63 | + |
| 64 | +>Note that it may take up to a minute for the device to appear after connecting it. |
| 65 | +
|
| 66 | +3. Run `adb shell`. If you have not set up your board prior to this via the Arduino App Lab, you may be required to provide a password, which is `arduino`. |
| 67 | +4. You should now be inside your board's terminal. |
| 68 | + |
| 69 | +  |
| 70 | + |
| 71 | +5. You are now able to run commands via the terminal on your board! To exit from the terminal, simply type `exit`. |
0 commit comments