Skip to content

Commit 3660b92

Browse files
committed
init move adb section
1 parent f801eaa commit 3660b92

File tree

1 file changed

+71
-0
lines changed
  • content/hardware/02.uno/boards/uno-q/tutorials/06.adb

1 file changed

+71
-0
lines changed
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
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+
![Connected devices](assets/connected-devices.png)
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+
![Terminal on the board.](assets/board-terminal.png)
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

Comments
 (0)