You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+21-15
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,9 @@
2
2

3
3
## A Go package for sensor mesh orchestration powered by gRPC & Protocol Buffers with a built-in FyrCLI.
4
4
5
-
**Version: 0.2.0**
5
+
**Version: 0.3.0**
6
6
**Platform: Raspbian OS & Windows**
7
-
**Language: Go 1.16 & Python 3.8**
7
+
**Language: Go 1.16 & Python 3.9**
8
8
**License: MIT**
9
9
10
10
### **Contributors**
@@ -73,7 +73,7 @@ For more information:
73
73
-[Working with Protocol Buffers](https://grpc.io/docs/what-is-grpc/introduction/#working-with-protocol-buffers)
74
74
75
75
### **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.
77
77
78
78
#### 1. Prerequisites
79
79
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
94
94
go get -u github.com/fyrwatch/fyrmesh
95
95
```
96
96
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
+
97
99
#### 2. Install FyrMesh
98
100
- Navigate into the ``/fyrmesh`` directory of the repository after downloading it.
99
101
- Open a terminal window in this directory and run the following command
100
102
```
101
-
python3 install.py
103
+
python install.py
102
104
```
103
105
- The FyrMesh components will now be installed.
104
106
@@ -115,19 +117,19 @@ The steps to add environment variables are detailed below for each platform.
115
117
```
116
118
- Add the following lines to ``fyrmesh.sh`` file.
117
119
```
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>
121
123
```
122
-
The recommended value for ``FYRMESHCONFIG`` is ``/home/pi/.fyrmesh/config.json``
124
+
The recommended value for ``FYRMESHCONFIG`` is ``/home/pi/.fyrmesh``
123
125
The recommended value for go bin path extension is ``/home/pi/go/bin``
124
126
- Reboot the system to apply changes.
125
127
126
128
##### Windows
127
129
- Press the Start Menu and type *'env*'.
128
130
- An option *'Edit the environment variables for your account'* will appear. Select it.
129
131
- 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``.
131
133
- Repeat and fill in the value for ``FYRMESHSRC`` with the path to the install directory.
132
134
- PATH extension wouldn't be required because the Go installer for windows handles it.
133
135
- Reboot the systems to apply changes.
@@ -143,22 +145,26 @@ The output will be something along the lines of the following.
143
145
A CLI Application to interact with the FyrMesh API. Powered by Cobra CLI, Golang and gRPC.
144
146
145
147
Usage:
146
-
FyrCLI [command]
148
+
fyrcli [command]
147
149
148
150
Available Commands:
149
151
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.
151
154
connect Set the connection state of the control node.
152
155
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
155
161
status Displays the current status of the mesh.
156
162
157
163
Flags:
158
164
--config string config file (default is $HOME/.cli.yaml)
159
-
-h, --help help for FyrCLI
165
+
-h, --help help for fyrcli
160
166
161
-
Use "FyrCLI [command] --help" for more information about a command.
167
+
Use "fyrcli [command] --help" for more information about a command.
162
168
```
163
169
164
170
You can also run ``fyrcli help <command>`` or ``fyrcli <command> --help`` to recieve the
0 commit comments