Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/androidthings/sample-nativepio
Basic Peripheral I/O examples in C/C++ with Android Things
https://github.com/androidthings/sample-nativepio
android-ndk android-things
Last synced: 4 days ago
JSON representation
Basic Peripheral I/O examples in C/C++ with Android Things
- Host: GitHub
- URL: https://github.com/androidthings/sample-nativepio
- Owner: androidthings
- License: apache-2.0
- Created: 2017-02-09T16:35:39.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-05-26T17:55:26.000Z (over 3 years ago)
- Last Synced: 2024-08-01T17:23:47.743Z (3 months ago)
- Topics: android-ndk, android-things
- Language: C++
- Homepage:
- Size: 7.19 MB
- Stars: 48
- Watchers: 4
- Forks: 67
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-things - sample-nativepio - 3 simple examples using native c++ peripheral IO API. (Useful links / Sample apps and libraries)
- awesome-android-things - sample-nativepio - 3 simple examples using native c++ peripheral IO API. (Useful links / Sample apps and libraries)
README
# Native Peripheral I/O
This Android Things app runs basic code that exercises the
[Native PIO APIs][native-pio] from C++. Each sample is an Android module that
can be run independently.
> **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
### Blink
![Blink sample demo][demo1-gif]
[(Watch the demo on YouTube)][demo1-yt]
### Button
![Button sample demo][demo2-gif]
[(Watch the demo on YouTube)][demo2-yt]
### Speaker
![Speaker sample demo][demo3-gif]
[(Watch the demo on YouTube)][demo3-yt]
## Pre-requisites
- Android Things compatible board
- Android Studio 2.2+
- Android NDK bundle
For the Blink sample:
- 1 LED
- 1 resistor
- 2 jumper wires
- 1 breadboard
For the Button sample:
- 1 push button
- 1 resistor
- 2 jumper wires
- 1 breadboard
For the Speaker sample:
- 1 piezo buzzer
- 2 jumper wires
- 1 breadboard
## Build and install
[Download][releases] the latest Android Things native library release
and extract it in the project root directory. You will need to change
the name of the extracted directory to `libandroidthings`.
The project root directory should contain the following native library
directories:
```
libandroidthings/
${ABI}/
include/
pio/
*.h
lib/
libandroidthings.so
```
On Android Studio, select the module in the select box by the "Run" button, and
then 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.nativepio/.
```
## Sample Specifics
### Blink
```bash
./gradlew blink:installDebug
adb shell am start com.example.androidthings.nativepio/android.app.NativeActivity
```
Blinks an LED connected to a GPIO pin.
### Button
```bash
./gradlew button:installDebug
adb shell am start com.example.androidthings.nativepio/android.app.NativeActivity
```
Logs to logcat when a button connected to a GPIO pin is pressed. Make sure you
use a pull-down or pull-up resistor to avoid fluctuation.
### Speaker
```bash
./gradlew speaker:installDebug
adb shell am start com.example.androidthings.nativepio/android.app.NativeActivity
```
Plays an annoying alarm sound on the PWM speaker. Stop it by turning off the
Raspberry Pi.
## Enable auto-launch behavior
This sample app is currently configured to launch only when deployed from your
development machine. To enable the main activity to launch automatically on boot,
add the following `intent-filter` to the app's manifest file:
```xml
```
## 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.
[native-pio]: https://developer.android.com/things/sdk/pio/native.html
[releases]: https://github.com/androidthings/native-libandroidthings/releases
[demo1-yt]: https://www.youtube.com/watch?v=47Rie4JpJ5M&index=7&list=PLWz5rJ2EKKc-GjpNkFe9q3DhE2voJscDT
[demo1-gif]: demo1.gif
[demo2-yt]: https://www.youtube.com/watch?v=ocHuWSHY0JA&list=PLWz5rJ2EKKc-GjpNkFe9q3DhE2voJscDT&index=8
[demo2-gif]: demo2.gif
[demo3-yt]: https://www.youtube.com/watch?v=xx6eCzG5Tq8&list=PLWz5rJ2EKKc-GjpNkFe9q3DhE2voJscDT&index=9
[demo3-gif]: demo3.gif