Android Things user-space drivers
Sample peripheral drivers for Android Things.
NOTE: these drivers are not production-ready. They are offered as sample implementations of Android Things user space drivers for common peripherals as part of the Developer Preview release. There is no guarantee of correctness, completeness or robustness.
How to use a driver
For your convenience, drivers in this repository are also published to JCenter as Maven artifacts. Look at their artifact and group ID in their build.gradle and add them as dependencies to your own project.
For example, to use the sh1106 driver, version 1.0, simply add the line
below to your project's build.gradle:
dependencies {
compile 'com.leinardi.android.things:driver-sh1106:1.0'
}
Current contrib drivers
| Driver | Type | Usage (add to your gradle dependencies) | Note |
|---|---|---|---|
| driver-ds3231 | real-time clock (RTC) | implementation 'com.leinardi.android.things:driver-ds3231:1.0' |
 changelog sample driver-ds3231-receiver |
| driver-epaperdriverhat | E-Paper Driver HAT | implementation 'com.leinardi.android.things:driver-epaperdriverhat:1.0' |
 changelog sample |
| driver-hcsr04 | ultrasonic ranging module | implementation 'com.leinardi.android.things:driver-hcsr04:1.0' |
 changelog sample |
| driver-hd44780 | alphanumeric dot matrix LCD | implementation 'com.leinardi.android.things:driver-hd44780:1.0' |
 changelog sample |
| driver-lsm9ds1 | 3D accelerometer, 3D gyroscope, 3D magnetometer and temperature sensor | implementation 'com.leinardi.android.things:driver-lsm9ds1:1.0' |
 changelog sample |
| driver-sh1106 | OLED display | implementation 'com.leinardi.android.things:driver-sh1106:1.0' |
 changelog sample |
| driver-tsl256x | light-to-digital converter | implementation 'com.leinardi.android.things:driver-tsl256x:1.0' |
 changelog sample |
Change of group ID and package name
If you are using the version 0.1 of driver-lsm9ds1, driver-pcf8574-hd44780 or driver-sh1106 please be aware that
the group ID and package name of these drives have been changed from com.leinardi.androidthings to com.leinardi.android.things.
If you want to use a version later than 0.1 you need to update your build.gradle to use the new group id and the imports in your Java/Kotlin files to use the new package name.
In addition to this, also the artifact ID of driver-pcf8574-hd44780 has been changed to driver-hd44780.
License
Copyright 2018 Roberto Leinardi.
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.