Update Get it Running - Step by Step.md

source/usage/Get it Running - Step by Step.md

@@ -76,6 +76,9 @@ You will see some values popping op from time to time.
 **Configure Diflouroborane**
 Open the file "bffh.dhall" in the GUI Editor (just by double-clicking it) or use `nano bffh.dhall` in your console.<br>
 
+Link the server to the MQTT-broker<br>
+find the line which starts with `, listens`. You will find three lines stating addresses. The third address needs to be changed to the adress of your MQTT broker (most likely the IP adress of your BFFH server)
+
 First you have to make your "actors" (in our case the Shellies) know to the system.<br>
 Go to the line where it starts with `, actors =` and after the `{` you can enter your Shelly with <br>
 `shelly1-123456789ABC = { module = "Shelly", params = {=}}`<br>
@@ -83,45 +86,29 @@ The ID of the Shelly should match the ID of your Shelly. Here you can enter as m
 
 Now you have to link a "machine" to an "actor".<br>
 Go to the line starting with `{actors_connections =` and after the following `[` you add<br>
-`{ machine = "Name-of-your-Machine", actor = "shelly1-E8DB84A1CFF4" }` using your own Name-of-your-Machine and the Shelly-ID of the related actor.
+`{ machine = "Identifyer-of-your-Machine", actor = "shelly1-E8DB84A1CFF4" }` using your own Name-of-your-Machine and the Shelly-ID of the related actor.
 
-Now you have to set the access-permissions to your machine.<br>
+Now you have to set the "access-permissions" to your "machine".<br>
 Go to the line starting with `, machines =`. and after the `{` you can add a machine:<br>
-`Name-of-your-Machine =` <br>
+`Identifyer-of-your-Machine =` <br>
 `   { description = Some "I am your first Testmachine"`<br>
 `   , disclose = "lab.test.read"`<br>
 `   , manage = "lab.test.admin"`<br>
-`    , name = "Shelly Rot"`<br>
+`    , name = "Name of the Machine"`<br>
 `    , read = "lab.test.read"`<br>
 `    , write = "lab.test.write"`<br>
 `    },`<br>
 
-Change the third IP-adress under "listens" to the IP-adress of your computer.
+Please be aware that "Identifyer-of-your-Machine" is the internal ID for BFFH. The name of the machine shown in the App will be "Name of the Machine".<br> 
-**- save**
+The given permissions are ok to start with (if you did not change the roles of the Testuser). To find out more about the permission concept see the "configuration" part of the documentation.
 
-21. start Diflouroburane
+**- save** (if you are using nano, this will be Ctrl-O )
-change to the directory in the console where you checked for the ip-address
-`cd BFFH/bffh/target/release`
-load settings to Diflouroborane:
-`./diflouroborane -c examples/bffh.dhall --load examples`
-start Diflouroborane:
-`./diflouroborane -c examples/bffh.dhall`
 
+**-restart the BFFH-server**
 **Important**
 every time you change the bffh.dhal you need to reload the settings (otherwise the App will not connect to the server on restart): 
 `./diflouroborane -c examples/bffh.dhall --load examples`
 and restart start Diflouroborane:
 `./diflouroborane -c examples/bffh.dhall`
 
-Download the borepin APP as described previously
+Open the App, an you should see the newly created machine in the list. By tapping "USE" you will activate the machine (Shelly will click, the MQTT-listener should promp an "on"), by tapping "GIVEBACK" you will deactivat the machine.
-- start the App
-- press: "Connect to new Server"
-- press: Enter the IP of your computer in the "Host"-Field
-- Enter your Username and Password.
-
-To connect to the demo instance
-- start the App
-- press: "Connect to new Server"
-- press: "Demo Host Address"
-- User: "Testuser"
-- Passw: "secret"