## Table of content

[[_TOC_]]

# Group 10 Contact sheet

<table>
<tr>
<th>Name</th>
<th>GitLab username</th>
<th>E-mail</th>
<th>Semester</th>
</tr>
<tr>
<td>Jacob</td>
<td>jaco4200</td>
<td><a href="mailto:@edu.ucl.dk">[e-mail]</a></td>
<td>Second</td>
</tr>
<tr>
<td>Jonas</td>
<td>jona8046</td>
<td><a href="mailto:@edu.ucl.dk">[e-mail]</a></td>
<td>Second</td>
</tr>
<tr>
<td>Lasse</td>
<td>lass3728</td>
<td><a href="mailto:@edu.ucl.dk">[e-mail]</a></td>
<td>Second</td>
</tr>
<tr>
<td>Rasmus</td>
<td>rasm702e</td>
<td><a href="mailto:@edu.ucl.dk">[e-mail]</a></td>
<td>Second</td>
</tr>
</table>

# Project plan
Project plan can be found [here](https://gitlab.com/20s-itt-dm-project/group-10/-/blob/master/Part%201/Setup/Project_plan_for_group10.md)

# Group 10 Documentation

## Boron board setup
Setup board by following [this link](https://eal-itt.gitlab.io/iot-with-particle/particle/boron_setup)

Update OS following [this link](https://docs.particle.io/tutorials/device-os/device-os/#managing-device-os)

Setup Visual studio code with particle workbench following [this link](https://eal-itt.gitlab.io/iot-with-particle/particle/particle_workbench)

---

## Serial setup

### Raspberry pi
1. Setting up the serial ports on the RPi using [this](https://spellfoundry.com/2016/05/29/configuring-gpio-serial-port-raspbian-jessie-including-pi-3-4/) guide

2. Connect the pins (TXD, RXD) to the correct opposing pins on the Particle Boron board (TXD to RX, RXD to TX) or look at the picture below.
(Connecting the boron board to a ground pin is a MUST!)


3. This step is not used in the final setup, but was only used during testing before we deployed Node-Red
It is recommended to just skip this step and go directly to using the Node-Red setup
Navigate to [Code folder](https://gitlab.com/20s-itt-dm-project/group-10/-/tree/master/Part%201/Setup/Code) and grab the [RPi_2way_serial_comms.py](https://gitlab.com/20s-itt-dm-project/group-10/-/blob/master/Part%201/Setup/Code/2_way_serial_comms.py) file, and run it on your Pi (It is needed to have the pins connected correctly to the boron board in order for the script to output data). The python script used on the raspberry pi is pretty basic, it opens up a serial communication on the ttyAMA0 port with a baud rate of 9600bps. after that it prompts the user for a input, then sends that input to the serial port, then listens for a reply, then loops when there is or isn’t a reply.

### Boron board
Using Visual Studio Code compile [“Node-RED & Cloud.ino”](https://gitlab.com/20s-itt-dm-project/group-10/-/blob/master/Part%201/Setup/Code/Node-RED%20&%20Cloud.ino) .
After that flash “Node-RED & Cloud.ino” onto your Boron Board.

Then whatever is sent from the boron board will be shown on the Node-Red interface.

---

## Node-RED
Use [this link](https://nodered.org/docs/getting-started/raspberrypi) and find the bash curl command, to use for installing node-RED on your raspberry pi.
Once the script is done running, you should reboot the pi.
After reboot run node-RED, which shows a terminal window. The terminal window will tell you if there are any problems.
Node-RED is now up, and accessible from your RPi, or your linked/hotspotted computer.
To access it simply type **raspberrypi.local:1880** or your RPis IP address followed by 1880, into your desired internet browser.
**1880** is the default port node-RED is setup on.
From there you're able to set nodes together and "script" trough the node blocks.
The json code to setup the Node-Red interface can be imported to Node-Red by downloading [this code](https://gitlab.com/20s-itt-dm-project/group-10/-/blob/master/Part%201/Setup/Code/Node-RED%20cloud%20and%20UI.json) and importing it as shown on the pictures below


### Our Node-RED dashboard

---

## Orcad test simulation
Current loop tester with module interface

Follow the picture instructions - very important that you use the exact pictured components.

Looptester and interface module combined simulation

voltage going from 0 to 3.3v