Skip to content

Files

Latest commit

 

History

History
69 lines (50 loc) · 5.75 KB

README.md

File metadata and controls

69 lines (50 loc) · 5.75 KB

Android Things user-space drivers

Build Status GitHub license

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' Maven metadata URI changelog sample driver-ds3231-receiver
driver-epaperdriverhat E-Paper Driver HAT implementation 'com.leinardi.android.things:driver-epaperdriverhat:1.0' Maven metadata URI changelog sample
driver-hcsr04 ultrasonic ranging module implementation 'com.leinardi.android.things:driver-hcsr04:1.0' Maven metadata URI changelog sample
driver-hd44780 alphanumeric dot matrix LCD implementation 'com.leinardi.android.things:driver-hd44780:1.0' Maven metadata URI changelog sample
driver-lsm9ds1 3D accelerometer, 3D gyroscope, 3D magnetometer and temperature sensor implementation 'com.leinardi.android.things:driver-lsm9ds1:1.0' Maven metadata URI changelog sample
driver-sh1106 OLED display implementation 'com.leinardi.android.things:driver-sh1106:1.0' Maven metadata URI changelog sample
driver-tsl256x light-to-digital converter implementation 'com.leinardi.android.things:driver-tsl256x:1.0' Maven metadata URI 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.