Skip to content

Commit

Permalink
docs updated
Browse files Browse the repository at this point in the history
  • Loading branch information
ogghst committed Jan 17, 2022
1 parent 52000bd commit 9906468
Show file tree
Hide file tree
Showing 2 changed files with 78 additions and 78 deletions.
78 changes: 39 additions & 39 deletions docs/platform.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,53 @@
# Reference Guide
# A quick look into GrowNode systems

## Node
This page describes how the GrowNode platform is structured and the technology behind it.

### Responsibilites
todo
## Architecture

### Configuration
todo
A full GrowNode system architecture is composed by

### Examples
todo
- one or more grownode boards (called nodes)
- each board is connected to several sensors (called leaves)
- a messaging server where each board talks using MQTT
- an automation server - like openhab, home assistant - that orchestrate the node operations
- several clients to display and manage nodes
- other systems, like home automation, gardening, that works together with grownode

<p align="center">
<img src="../img/grownode_net.png">
</p>

## Leaves
## Working tools

### Responsibilites
todo
GrowNode aims to use most common development tools. Actual release is composed by:

### Configuration
todo
### Hardware

### Examples
todo
- [ESP32](https://www.espressif.com/en/products/socs/esp32) and above microcontrollers
- Common sensors and actuators (relay, PWM output, temperature probes, capacitance sensors..) with any esp-idf compatible libraries

- (optional) Various displays tested (ILI9341) with touch screen (tested XPT2046) capabilities
- (optional) A server like a raspberry to host the server side components in case you want to develop a network solution


## Parameters
### Software Components

### Responsibilites
todo
- ESP-IDF (release 4.4) programming environment

- (optional) MQTT broker as a messaging system - if you want to exchange info between boards and servers
- (optional) LVGL as display library - if you want to attach a screen to display your sensor values
- (optional) OpenHab/Home Assistant as a controller

### Configuration
todo
## Functionalities

### Examples
todo

## MQTT Protocol

todo

### Leaf - Server messaging

todo

### Leaf - leaf messaging

todo


## Display Configuration

todo
Grownode provides functionalities that lets you kickstart your projects in minutes:

- SoftAP/Bluetooth Provisioning to join and change your wireless network without any hardcode configuration through a mobile app
- High level device configuration through makefile
- Firmware update Over The Air
- NTP clock sync
- Persistent storage of parameters
- Sensor and Actuators configuration abstracting the hardware level
- Transparent networking protocol (presentation, keepalive, logging)
- Client/Server and Client/Client parameter retrieval and update through MQTT

78 changes: 39 additions & 39 deletions docs/reference.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,53 @@
# A quick look into GrowNode systems
# Reference Guide

This page describes how the GrowNode platform is structured and the technology behind it.
## Node

## Architecture
### Responsibilites
todo

A full GrowNode system architecture is composed by
### Configuration
todo

- one or more grownode boards (called nodes)
- each board is connected to several sensors (called leaves)
- a messaging server where each board talks using MQTT
- an automation server - like openhab, home assistant - that orchestrate the node operations
- several clients to display and manage nodes
- other systems, like home automation, gardening, that works together with grownode
### Examples
todo

<p align="center">
<img src="../img/grownode_net.png">
</p>

## Working tools
## Leaves

GrowNode aims to use most common development tools. Actual release is composed by:
### Responsibilites
todo

### Hardware
### Configuration
todo

- [ESP32](https://www.espressif.com/en/products/socs/esp32) and above microcontrollers
- Common sensors and actuators (relay, PWM output, temperature probes, capacitance sensors..) with any esp-idf compatible libraries

- (optional) Various displays tested (ILI9341) with touch screen (tested XPT2046) capabilities
- (optional) A server like a raspberry to host the server side components in case you want to develop a network solution

### Examples
todo

### Software Components
## Parameters

- ESP-IDF (release 4.4) programming environment

- (optional) MQTT broker as a messaging system - if you want to exchange info between boards and servers
- (optional) LVGL as display library - if you want to attach a screen to display your sensor values
- (optional) OpenHab/Home Assistant as a controller
### Responsibilites
todo

## Functionalities
### Configuration
todo

Grownode provides functionalities that lets you kickstart your projects in minutes:
### Examples
todo

## MQTT Protocol

todo

### Leaf - Server messaging

todo

### Leaf - leaf messaging

todo


## Display Configuration

todo

- SoftAP/Bluetooth Provisioning to join and change your wireless network without any hardcode configuration through a mobile app
- High level device configuration through makefile
- Firmware update Over The Air
- NTP clock sync
- Persistent storage of parameters
- Sensor and Actuators configuration abstracting the hardware level
- Transparent networking protocol (presentation, keepalive, logging)
- Client/Server and Client/Client parameter retrieval and update through MQTT

0 comments on commit 9906468

Please sign in to comment.