IoT Starter for Android

This is an IoT starter project to send phone's accelerometer data to NodeRED over MQTT.

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

There are a number of IoT Starter Projects out there for you to explore. The purpose of this project is to provide you with an easy to use example of an IoT Project with the latest tech-trends in IoT space. This project doesn't require any hardware and make use of your Android Smartphone accelerometer sensor.

How it works?

This project has 3 parts.

• An android smartphone app to collect phone accelerometer data and send it to node-red dashboard over MQTT.
• An MQTT Broker(running on a Ubuntu Server) to receive data from smartphone app and forward it to NodeRED dashboard for visualization.
• A NodeRED app running on IBM Cloud to visualize the accelerometer data in real-time.

Once you run this project succesfully, you will be able to implement same set of instructions on your next IoT project.

(back to top)

Built With

IoT Starter is built with

• Android Studio
• NodeRED
• Mosquitto
• IBM Cloud

(back to top)

Getting Started

This section provides a set of instructions on how to run this project.

Prerequisites

This is a list things you need have.

• Android Studio(optional)
• IBM Cloud Account

Installation

1. Compile the andorid app or use APK file and install it on your smartphone.
2. Make a Classic Ubuntu Server 20.04 instance in your IBM Cloud account and install mosquitto broker on it.
3. Install NodeRED in your IBM Cloud Account
4. Install node-red-dashboard in your NodeRED instance.
5. Import the flow from NodeREDDashboard folder of this repository into your NodeRED dashboard.

(back to top)

Usage

Install the compiled android app on your Android Phone and in settings page put the public IP address of your Ubuntu Server 20.04 instance as a broker address and in the topic you can put data/val/accelerometer and then on the homepage of the app you can press start to start sending the data to the dashboard.

You can visulaize the data on the NodeRED dashboard ui page usually at the address http://appURL/ui

(back to top)

Roadmap

• Add Android App
• Add iOS App
• Add a standalone hardware example.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the Eclipse Public License 1.0 License. See LICENSE for more information.

(back to top)

Contact

NaumanShakir - NaumanShakir.com - @Nauman3S - [email protected]

Project Link: https://github.com/Nauman3S/iot-starter-android

(back to top)