Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/androidthings/sample-uartloopback
Echo received characters over a UART with Android Things
https://github.com/androidthings/sample-uartloopback
android-things
Last synced: 9 days ago
JSON representation
Echo received characters over a UART with Android Things
- Host: GitHub
- URL: https://github.com/androidthings/sample-uartloopback
- Owner: androidthings
- License: apache-2.0
- Created: 2016-12-13T16:14:41.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-05-26T17:55:40.000Z (over 3 years ago)
- Last Synced: 2024-08-01T17:23:41.485Z (3 months ago)
- Topics: android-things
- Language: Java
- Homepage:
- Size: 1.59 MB
- Stars: 78
- Watchers: 11
- Forks: 39
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-things - sample-uartloopback - UART Loopback sample for Android Things. (Useful links / Sample apps and libraries)
- awesome-android-things - sample-uartloopback - UART Loopback sample for Android Things. (Useful links / Sample apps and libraries)
README
# UART Loopback
This sample demonstrates basic data read and write operations over a UART.
The application creates a loopback interface that immediately echoes
any data read from the receive (RX) buffer to the transmit (TX) buffer.
> **Note:** The Android Things Console will be turned down for non-commercial
> use on January 5, 2022. For more details, see the
> [FAQ page](https://developer.android.com/things/faq).
## Screenshots
![UART Loopback sample demo][demo-gif]
[(Watch the demo on YouTube)][demo-yt]
## Pre-requisites
- Android Things compatible board with an available UART port
- Android Studio 2.2+
- [FTDI TTL-232R](http://www.ftdichip.com/Products/Cables/USBTTLSerial.htm)
or compatible USB-TTL converter
## Schematics
NOTE: Raspberry Pi 3 shares the UART pins between multiple ports, including the serial debugging
console. Refer to the [mode matrix][pi3-modes] for more details.
Check in the USB TTL cable's documentation for the TX and RX wire colors:
- connect the cable TX wire to the board RX pin
- connect the cable RX wire to the board TX pin
## Build and install
1. On Android Studio, click on the "Run" button.
If you prefer to run on the command line, type
```bash
./gradlew installDebug
adb shell am start com.example.androidthings.loopback/.LoopbackActivity
```
2. Plug the USB-TTL converter into a host PC, start your favorite terminal
program (minicom, screen, RealTerm, etc.), and connect to the USB-TTL port
at 115200 baud.
3. Type characters into the terminal and observe them echo back to you from the device.
## License
Copyright 2016 The Android Open Source Project, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements. See the NOTICE file distributed with this work for
additional information regarding copyright ownership. The ASF licenses this
file to you under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
[pi3-modes]: https://developer.android.com/things/hardware/raspberrypi-mode-matrix.html
[demo-yt]: https://www.youtube.com/watch?v=OBprmZ00T3E&index=12&list=PLWz5rJ2EKKc-GjpNkFe9q3DhE2voJscDT
[demo-gif]: demo1.gif