Skip to content
/ NucuCar Public

NucuCar is a .Net Core IoT application for environment monitoring and home automation powered by Raspberry Pi.

License

Notifications You must be signed in to change notification settings

dnutiu/NucuCar

Repository files navigation

Introduction (WIP)

An attempt to create a remote weather station hub on the Raspberry Pi.

The repository consists on several modules written in C# and an Android application written in Java.

Communication between the Raspberry and the Android application is done via the telemetry publishers.

The project is still undergoing development and it's not production ready.

CircleCI

Architecture

TBD

Installing and Developing

Requirements

To build this project you will need to install .Net Core 3.1 and Android Studio.

To run this project on the Raspberry Pi you will need dotnet core 3.1. installed.

Building

The following script provides instructions on how to build the whole project and deploy the NucuCar.Sensors module on the Raspberry Pi.

Manual

// Build project
dotnet build --runtime linux-arm -p:PublishSingleFile=true --configuration Release

// Navigate to desired project directory, for example NucuCar.Sensors.
cd NucuCar.Sensors

// Create .tar
tar -zcvf nh.tar.gz .\bin\Release\netcoreapp3.1\linux-arm\*

// Copy onto pi (replace with your ip, user)
sftp [email protected]
sftp> put nh.tar.gz
sftp> exit

// SSH into pi
ssh [email protected]

// Extract the archive and cd into it
tar -zxvf nh.tar.gz
cd bin/Release/netcoreapp3.1/linux-arm/

// Grant execution permissions
chmod +x NucuCar.Sensors

// Run the program
./NucuCar.Sensors

To make it easier for you to run the project, you may define a SystemD service for it:

1. Create the SystemD service file with the following command:

sudo nano /etc/systemd/system/nucucar_sensors.service

2. Paste the following contents and make sure to update the WorkingDirectory and ExecStarts paths:

[Unit]
Description=NucuCar.Sensors SystemD Service.
After=network.target

[Service]
User=pi
Group=pi
WorkingDirectory=/home/pi/NucuCar/bin/Release/netcoreapp3.1/linux-arm
ExecStart=/home/pi/NucuCar/bin/Release/netcoreapp3.1/linux-arm/NucuCar.Sensors


[Install]
WantedBy=multi-user.target

3. SystemD commands

sudo systemctl start nucucar_sensors
sudo systemctl stop nucucar_sensors
sudo systemctl restart nucucar_sensors
sudo systemctl status nucucar_sensors

Enable starts the service after the pi has booted, disable undoes what enable does.

sudo systemctl enable nucucar_sensors
sudo systemctl disable nucucar_sensors

To browse the logs for the session and all logs of the service:

journalctl -e -u nucucar_sensors.service
journalctl -u nucucar_sensors.service

Directory Structure Overview

NucuHub.Android

Holds the Android application.

We are currently targeting Android API 29+.

NucuCar.Domain

Holds common classes and interfaces that are required by the projects, provides all the types that are generated via protocol buffers and some utility classes.

NucuCar.Telemetry

Holds concrete implementation for telemetry publishers and workers. The Telemetry project can be used by other projects such as NucuCar.Sensors to send telemetry into the cloud.

This project is not deployed.

NucuCar.Sensors

Manages all the sensors. For more info see the readme file located in the project directory.

This module is runnable and is deployed on the Raspberry Pi.

Docs

Holds project resources and documentation.

About

NucuCar is a .Net Core IoT application for environment monitoring and home automation powered by Raspberry Pi.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published