From 235663d2a78efe9bbffca5814b74c4ab45fc992d Mon Sep 17 00:00:00 2001 From: Denis Nutiu Date: Fri, 30 Apr 2021 16:29:21 +0300 Subject: [PATCH] NUC-34: Improve documentation. --- Docs/images/nucucar_android.png | Bin 0 -> 86606 bytes NucuCar.Domain/Readme.md | 2 +- NucuCar.Sensors/Readme.md | 38 +++++++++++++++++++++++++++--- NucuCar.Telemetry/Readme.md | 40 +++++++++++++++++++++----------- NucuHub.Android/Readme.md | 7 ++++++ Readme.md | 2 -- 6 files changed, 70 insertions(+), 19 deletions(-) create mode 100644 Docs/images/nucucar_android.png create mode 100644 NucuHub.Android/Readme.md diff --git a/Docs/images/nucucar_android.png b/Docs/images/nucucar_android.png new file mode 100644 index 0000000000000000000000000000000000000000..8017c61c7bf33e18bf2639bf5bcf23b36ac7a7cf GIT binary patch literal 86606 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 WqCF8C<8clAQB&4ZDphzL{C@ye;X{@H literal 0 HcmV?d00001 diff --git a/NucuCar.Domain/Readme.md b/NucuCar.Domain/Readme.md index efcabd8..42b6797 100644 --- a/NucuCar.Domain/Readme.md +++ b/NucuCar.Domain/Readme.md @@ -1,4 +1,4 @@ -## Protos +# Protos The files from Protos are compiled by the gRPC compiler and provide data structures that are shared across the project. \ No newline at end of file diff --git a/NucuCar.Sensors/Readme.md b/NucuCar.Sensors/Readme.md index 46ecf79..f519e7f 100644 --- a/NucuCar.Sensors/Readme.md +++ b/NucuCar.Sensors/Readme.md @@ -11,16 +11,48 @@ _You may download the Fritzing diagrams from `Docs/fritzing/` in order to play w Wire your sensor according to the following diagram: -![alt text](../Docs/images/nucucar.sensors_bb.jpg) - +![raspberry pi wiring diagram](../Docs/images/nucucar.sensors_bb.jpg) #### BME680 -Connect the BME680 sensor to the I2C bus 1 (I2C.1) of the Raspberry Pi. +Connect the BME680 sensor to the I2C bus 1 (I2C.1) of the Raspberry Pi. The address ` 0x76` will be used to communicate with the sensor. Make sure I2C is enabled. Use `raspi-config`. +# Configuration + +Each Sensor is configured via the `appsettings.json` file. The following configuration options are +available to all sensors: + +- Enabled: (bool) Enables or disables the sensor. +- Telemetry: (bool) Enables or disables telemetry reporting for the sensor. +- Grpc: (bool): Enables or disables the gRPC endpoint for the sensor. +- MeasurementInterval: (int) The interval in milliseconds in which the sensor will read data. Default: 3000 + +--- +Besides sensor configuration, you may also configure the telemetry service. The telemetry service collects telemetry data from all sensors +and uses a telemetry publisher to publish the data. + +Example config: +``` +{ + "Telemetry": { + "Publisher": "Disk", + "ServiceEnabled": true, + "PublishInterval": 3000, + "ConnectionString": "FileName=nucucar.telemetry;FileExtension=txt;Separator=\n" + }, + "EnvironmentSensor": { + "Enabled": true, + "Telemetry": true, + "Grpc": true + }, +} +``` + +--- + # Sensors #### Environment Sensor diff --git a/NucuCar.Telemetry/Readme.md b/NucuCar.Telemetry/Readme.md index 6a24248..c10553e 100644 --- a/NucuCar.Telemetry/Readme.md +++ b/NucuCar.Telemetry/Readme.md @@ -1,12 +1,26 @@ -## Telemetry +# Telemetry -It provides useful classes and abstractions for implementing telemetry -in individual components. All telemetry publishers use the MQTT protocol unless specified -otherwise. +This package provides useful classes and abstractions for implementing telemetry +in individual components. -### Azure Telemetry +The telemetry service is used by other packages in order to implement telemetry reporting. It may be configured via the `appsettings.json` file or environment variables. -#### Publisher +# Configuration + +The following configurations is available for the Telemetry service: + +- Publisher: (string) The telemetry publisher. i.e: `Azure`, `Disk`, `Firestore`, `Console`. +- ServiceEnabled: (bool) Enables or disables the telemetry collection service. +- PublishInterval: (int) The interval in which to publish the telemetry data. +- ConnectionString: (string) Connection string for the telemetry publisher. + +# Telemetry Publishers + +Telemetry publishers are used by the telemetry service in order to publish data. + +## Azure Telemetry + +### Publisher You can use cloud telemetry for free via Azure-IoT-Hub. You still need a backend application that will process the messages. @@ -26,7 +40,7 @@ dotnet run --Telemetry:ConnectionString=CONNECTION_STRING export Telemetry:ConnectionString=CONNECTION_STRING ``` -The Telemetry:Publisher must be set to: Azure +The `Telemetry:Publisher` must be set to: Azure You may also use the format from above to override any settings in appsettings.json. @@ -37,16 +51,16 @@ Azure's IoT Hub Build-In Endpoints setting. --- -### Disk Telemetry +## Disk Telemetry -#### Publisher +### Publisher Publishes telemetry on the disk. Example connection string: `Filename=telemetry;FileExtension=csv;Separator=,;BufferSize=4096` -The Telemetry:Publisher must be set to: Disk +The `Telemetry:Publisher` must be set to: Disk See the source code for comments on the ConnectionString. @@ -56,13 +70,13 @@ You will need to parse the file by yourself. --- -### Firebase Firestore Database +## Firebase Firestore Database -#### Publisher +### Publisher Publishes telemetry on the firestore. -The Telemetry:Publisher must be set to: Firestore +The `Telemetry:Publisher` must be set to: Firestore Example connection string: `ProjectId=nucuhub;CollectionName=sensors-telemetry-test;Timeout=1000` diff --git a/NucuHub.Android/Readme.md b/NucuHub.Android/Readme.md new file mode 100644 index 0000000..8ac9ad6 --- /dev/null +++ b/NucuHub.Android/Readme.md @@ -0,0 +1,7 @@ +# Introduction + +This package holds the code for the NucuCar.Android companion application. + +The purpose of the application is to allow the user to interact with the NucuCar system via the mobile phone. + +![android application image](../Docs/images/nucucar_android.png) \ No newline at end of file diff --git a/Readme.md b/Readme.md index 6157d39..3f1963a 100644 --- a/Readme.md +++ b/Readme.md @@ -25,8 +25,6 @@ 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.