Skip to content

Commit 3c383d5

Browse files
Update README
- Bumped package to v0.3 - Added a statement about the cloud interface - Fixed references to the FYRMESHCONFIG env var
1 parent 3c70ca0 commit 3c383d5

File tree

1 file changed

+21
-15
lines changed

1 file changed

+21
-15
lines changed

README.md

+21-15
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
![FyrMesh Banner](fyrmesh.png)
33
## A Go package for sensor mesh orchestration powered by gRPC & Protocol Buffers with a built-in FyrCLI.
44

5-
**Version: 0.2.0**
5+
**Version: 0.3.0**
66
**Platform: Raspbian OS & Windows**
7-
**Language: Go 1.16 & Python 3.8**
7+
**Language: Go 1.16 & Python 3.9**
88
**License: MIT**
99

1010
### **Contributors**
@@ -73,7 +73,7 @@ For more information:
7373
- [Working with Protocol Buffers](https://grpc.io/docs/what-is-grpc/introduction/#working-with-protocol-buffers)
7474

7575
### **Installation**
76-
The FyrMesh library can be installed onto a Linux or a Windows system. Linux support is only intended for the Raspbian OS that is designed for the Raspberry Pi.
76+
The FyrMesh library can be installed onto a Linux or a Windows system. Linux support is only intended for the Raspbian OS that is designed for the Raspberry Pi.
7777

7878
#### 1. Prerequisites
7979
Install Go 1.16 and Python 3.8
@@ -94,11 +94,13 @@ Download this repository to some location on your system with one of the followi
9494
go get -u github.com/fyrwatch/fyrmesh
9595
```
9696

97+
At this stage, the project is only an application and not a fully managed service, so the set up of the cloud interface is upto the user. This involves having a **Google Cloud Platform** Project with billing enabled and a Firestore database created. An IAM Service Account with the role *Datastore User* must be created and JSON key for it must be generated. This key must exist in the ``FYRMESHCONFIG`` directory with the name *cloudconfig.json*
98+
9799
#### 2. Install FyrMesh
98100
- Navigate into the ``/fyrmesh`` directory of the repository after downloading it.
99101
- Open a terminal window in this directory and run the following command
100102
```
101-
python3 install.py
103+
python install.py
102104
```
103105
- The FyrMesh components will now be installed.
104106

@@ -115,19 +117,19 @@ The steps to add environment variables are detailed below for each platform.
115117
```
116118
- Add the following lines to ``fyrmesh.sh`` file.
117119
```
118-
export FYRMESHCONFIG=<<path to the config file>>
119-
export FYRMESHSRC=<<path to the repository source files directory>>
120-
export PATH=$PATH:<<path to Go bin install directory>>
120+
export FYRMESHCONFIG=<path to the config file directory>
121+
export FYRMESHSRC=<path to the repository source files directory>
122+
export PATH=$PATH:<path to Go bin install directory>
121123
```
122-
The recommended value for ``FYRMESHCONFIG`` is ``/home/pi/.fyrmesh/config.json``
124+
The recommended value for ``FYRMESHCONFIG`` is ``/home/pi/.fyrmesh``
123125
The recommended value for go bin path extension is ``/home/pi/go/bin``
124126
- Reboot the system to apply changes.
125127

126128
##### Windows
127129
- Press the Start Menu and type *'env*'.
128130
- An option *'Edit the environment variables for your account'* will appear. Select it.
129131
- A list of environment variables will be visible. Select the *'New'* option.
130-
- Fill in the value for ``FYRMESHCONFIG``. The recommended value is ``C:\Users\<user>\.fyrmesh\config.json``.
132+
- Fill in the value for ``FYRMESHCONFIG``. The recommended value is ``C:\Users\<user>\.fyrmesh``.
131133
- Repeat and fill in the value for ``FYRMESHSRC`` with the path to the install directory.
132134
- PATH extension wouldn't be required because the Go installer for windows handles it.
133135
- Reboot the systems to apply changes.
@@ -143,22 +145,26 @@ The output will be something along the lines of the following.
143145
A CLI Application to interact with the FyrMesh API. Powered by Cobra CLI, Golang and gRPC.
144146
145147
Usage:
146-
FyrCLI [command]
148+
fyrcli [command]
147149
148150
Available Commands:
149151
boot Boots a FyrMesh gRPC server.
150-
config View/Manipulate configuration values of the FyrCLI.
152+
command Sends a control command to the mesh.
153+
config View configuration values of the FyrCLI.
151154
connect Set the connection state of the control node.
152155
help Help about any command
153-
observe Observes the logstream of the ORCH server.
154-
ping Pings the mesh for sensor readings.
156+
nodelist Displays the list of nodes connected to the mesh.
157+
observe Observes the logstream from the ORCH server.
158+
ping Pings the mesh or a node.
159+
scheduler Sets the state of the Scheduler
160+
simulate Starts a simulation of a Fire Event
155161
status Displays the current status of the mesh.
156162
157163
Flags:
158164
--config string config file (default is $HOME/.cli.yaml)
159-
-h, --help help for FyrCLI
165+
-h, --help help for fyrcli
160166
161-
Use "FyrCLI [command] --help" for more information about a command.
167+
Use "fyrcli [command] --help" for more information about a command.
162168
```
163169

164170
You can also run ``fyrcli help <command>`` or ``fyrcli <command> --help`` to recieve the

0 commit comments

Comments
 (0)