Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/androidthings/weatherstation

Sensor-based peripheral sample using Android Things
https://github.com/androidthings/weatherstation

android-things google-cloud-pubsub

Last synced: 4 days ago
JSON representation

Sensor-based peripheral sample using Android Things

Awesome Lists containing this project

README 

        
# Weather Station



This sample integrates multiple Android Things peripheral drivers together to

build a connected Weather Station.



> **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



![Weather Station sample demo][demo-gif]



[(Watch the demo on YouTube)][demo-yt]



## Pre-requisites



- Android Things compatible board

- Android Studio 2.2+

- [Rainbow Hat for Android Things](https://shop.pimoroni.com/products/rainbow-hat-for-android-things) or the following individual components:

    - 1 [bmp280 temperature sensor](https://www.adafruit.com/product/2651)

    - 1 [segment display with I2C backpack](https://www.adafruit.com/product/879)

    - 1 push button

    - 1 resistor

    - jumper wires

    - 1 breadboard

    - (optional) 1 [APA102 compatible RGB Led strip](https://www.adafruit.com/product/2241)

    - (optional) 1 [Piezo Buzzer](https://www.adafruit.com/products/160)

    - (optional) [Google Cloud Platform](https://cloud.google.com/) project



## Schematics



If you have the Raspberry Pi [Rainbow Hat for Android Things](https://shop.pimoroni.com/products/rainbow-hat-for-android-things), just plug it onto your Raspberry Pi 3.



![Schematics for Raspberry Pi 3](rpi3_schematics.png)



## Build and install



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.weatherstation/.WeatherStationActivity

```



If you have everything set up correctly:

- The segment display will show the current temperature.

- If the button is pressed, the display will show the current pressure.

- If a Piezo Buzzer is connected, it will plays a funny sound on startup.

- If a APA102 RGB Led strip is connected, it will display a rainbow of 7 pixels indicating the current pressure.

- If a Google Cloud Platform project is configured (see instruction below), it will publish the sensor data to Google Cloud PubSub.



## Google Cloud Platform configuration (optional)



1. Go to your project in the [Google Cloud Platform console](https://console.cloud.google.com/)

1. Under *API Manager*, enable the following APIs: Cloud Pub/Sub

1. Under *IAM & Admin*, create a new Service Account, provision a new private key and save the generated json credentials.

1. Under *Pub/Sub*: create a new topic and in the *Permissions* add the service account created in the previous step with the role *Pub/Sub Publisher*.

1. Under *Pub/Sub*: create a new *Pull subscription* on your new topic.

1. Import the project into Android Studio. Add a file named `credentials.json` inside `app/src/main/res/raw/` with the contents of the credentials you downloaded in the previous steps.

1. In `app/build.gradle`, replace the `buildConfigField` values with values from your project setup.



After running the sample, you can check that your data is ingested in Google Cloud Pub/Sub by running the following command:

```

gcloud --project  beta pubsub subscriptions pull 

```



Note: If there is no `credentials.json` file in `app/src/main/res/raw`, the app will

 run offline and will not send sensor data to the [Google Cloud Pub/Sub](https://cloud.google.com/pubsub/).



## Next steps



Now your weather sensor data is continuously being published to [Google Cloud Pub/Sub](https://cloud.google.com/pubsub/):

- process weather data with [Google Cloud Dataflow](https://cloud.google.com/dataflow/) or [Google Cloud Functions](https://cloud.google.com/functions/)

- persist weather data in [Google Cloud Bigtable](https://cloud.google.com/bigtable/) or [BigQuery](https://cloud.google.com/bigquery/)

- create some weather visualization with [Google Cloud Datalab](https://cloud.google.com/datalab/)

- build weather prediction model with [Google Cloud Machine Learning](https://cloud.google.com/ml/)



## 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.



[demo-yt]: https://www.youtube.com/watch?v=FcdwfKehX_0&list=PLWz5rJ2EKKc-GjpNkFe9q3DhE2voJscDT&index=14

[demo-gif]: demo1.gif