Giter VIP home page Giter VIP logo

ble-app's Introduction

Android BLE Background Color Change App

Introduction

This Android application demonstrates the use of Bluetooth Low Energy (BLE) technology to change the background color of the app's screen. The application acts as a BLE Peripheral device, advertising a custom service that allows connected BLE Central devices to write a value to a characteristic, which in turn changes the screen color.

Features

  • Implements MVVM architecture for clean separation of concerns and better testability.
  • Uses Jetpack Compose for a modern, declarative UI.
  • Utilizes Dagger/Hilt for dependency injection to provide a scalable and maintainable codebase.
  • Includes unit tests with JUnit and MockK for robustness and reliability.
  • Advertises as a BLE Peripheral and changes the app's background color based on characteristic writes.

BLE Service Details

  • Service UUID: 13b402b6-ff2c-4175-a157-7e888b192a45
  • Characteristic UUID: c0a130aa-7409-484a-935a-ff81c1d4ef96
  • Accepts an 8-bit unsigned integer (UInt8) value.

Getting Started

To run this application, you will need an Android device with BLE capabilities and Android 9 or higher. Clone the repository, open the project in Android Studio, build the application, and run it on your device.

Prerequisites

  • Android Studio
  • A BLE-capable Android device running Android 9+

Installation

  1. Clone the repository to your local machine.
  2. Open the project with Android Studio.
  3. Connect your Android device to your development machine.
  4. Build the project and run the application on your device.

Testing

You can test the application's BLE functionality using a third-party BLE scanner app like LightBlue. Connect to the “Test AN” device and write values to the characteristic c0a130aa-7409-484a-935a-ff81c1d4ef96 to change the background color of the app.

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.

Contact

Ahmed Nezhi - Email

Acknowledgements

ble-app's People

Watchers

Ahmed Nezhi avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.