A Python package for Raspberry Pi
Project description
UVedor Hat
Software for the UVedora hat.
Getting started
to install the project consult the installation guide
Installation
Raspberry Pi
The python program can only be installed on the raspberry pi
Before you install the program please install the dependencies required for the program to run. these are described below
Installing uvraspy using pip
You can install uvraspy using pip by running the following command:
pip install uvedora
uvraspy is now installed on your raspberry pi and you can start the program by running the following command:
uvraspy
Installing uvraspy from source
You can also install uvraspy from source by running the following commands:
# Make sure you are in the desired directory
git init
git remote add -f origin https://gitlab.utwente.nl/computer-systems-project/2022-2023/student-projects/cs22-25/cs-22-25-assignments.git
git config core.sparseCheckout true
echo "RasPy/*" >> .git/info/sparse-checkout
git pull origin main
To run the program you can run the following command:
cd RasPy/
python3 -m uvraspy.main
Dependencies
You need to install the following dependencies before you can install the program:
sudo apt-get update
sudo apt install bluetooth bluez libbluetooth-dev libudev-dev
When installing from source you also need to install the python dependencies, these can be installed by running the following command:
pip install -r RasPy/requirements.txt
Sensors
Humidity-Temperature sensor (KY-015 DHT11)
(front-facing, connections downwards)
- connect left connection to GPIO 23 (pin 16)
- connect middle connection to 3V3 power (pin 1)
- connect right connection to Ground (pin 6)
Pressure sensor (BMP280)
- connect GND to Ground (pin 6)
- do not connect VCC
- connect SCL to GPIO 3 (SCL) (pin 5)
- connect SDA to GPIO 2 (SDA) (pin 3)
- do not connect CSB
- connect SDO to 3V3 power (pin 1)
UV Sensor (LTR390 ALS+UV Sensor)
- connect VIN to 3V3 power (pin 1)
- do not connect 3V0
- connect GND to Ground (pin 6)
- connect SCL to GPIO 3 (SCL) (pin 5)
- connect SDA to GPIO 2 (SDA) (pin 3)
- do not connect INT
Android
The android app can be installed on any android device running android 6.0 or higher.
Installing the app
You can install the app by downloading the apk file from the releases page and installing it on your android device
Building the app from source (only for developers)
To build the app from source you need to install the following tools:
- Android Studio (recommended)
- Android SDK (v33)
- Android build tools
- Android SDK Platform-Tools
- Android SDK Command-line Tools
- Flutter SDK
After installing the tools you can clone the repository and open the MobileApplication project in the terminal or in Android Studio
To build the app you can run the following command:
flutter build apk --release
The apk file can be found in build/app/outputs/flutter-apk/app-release.apk
Usage
Raspberry Pi
to run the program on the raspberry pi enter the following command:
uvraspy
Android
to run the program on android install the app from the releases page and run the app
when your hat is running you can connect to it using the app
Support and contact
if you have any questions or problems you can contact us by email or by creating an issue
Authors and acknowledgment
developed by:
special thanks to:
Contributing
if you want to contribute to the project you can create a merge request
make sure to read the contribution guidelines before you start contributing
License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
