diff --git a/docs/.vuepress/components/HardwareTableTemplate.vue b/docs/.vuepress/components/HardwareTableTemplate.vue
index ce37dba8..528b2e1f 100644
--- a/docs/.vuepress/components/HardwareTableTemplate.vue
+++ b/docs/.vuepress/components/HardwareTableTemplate.vue
@@ -6,7 +6,7 @@ export default {
type: Array,
default: () => [
{
- title: '#',
+ title: 'Name',
values: [0, 9],
// no length / voltage property -> always shown
},
@@ -90,9 +90,14 @@ export default {
-
{{ c.title }}
+
{{ c.title }}
diff --git a/docs/.vuepress/components/TableFoldback.vue b/docs/.vuepress/components/TableFoldback.vue
index 8d1967e6..71b0fe23 100644
--- a/docs/.vuepress/components/TableFoldback.vue
+++ b/docs/.vuepress/components/TableFoldback.vue
@@ -4,60 +4,70 @@ export default {
data: () => ({
values: [
{
- title: '#',
- values: ['XX', 'XX'],
+ title: 'Name',
+ url: true,
+ values: [
+ {
+ title: 'element_2800',
+ url: 'https://store.brewpi.com/stainless-steel-foldback-heating-element-2800w-27cm',
+ },
+ {
+ title: 'element_3200',
+ url: 'https://store.brewpi.com/stainless-steel-foldback-heating-element-3200w-32cm',
+ },
+ ],
},
{
- title: 'Length (cm)',
+ title: 'Length\n (cm)',
length: 'cm',
values: [27, 32],
},
{
- title: 'Min. kettle ⌀ (cm)',
+ title: 'Min. kettle\n ⌀ (cm)',
length: 'cm',
- values: [30, 30],
+ values: [30, 35],
},
{
- title: 'Length (in)',
+ title: 'Length\n (in)',
length: 'inch',
values: [10.6, 12.6].map((v) => v.toFixed(1)),
},
{
- title: 'Min. kettle ⌀ (in)',
+ title: 'Min. kettle\n ⌀ (in)',
length: 'inch',
values: [11.8, 13.8].map((v) => v.toFixed(1)),
},
{
- title: 'No. Resistors',
+ title: 'No.\n Resistors',
values: [1, 1],
},
{
- title: 'Current (A)',
+ title: 'Current\n (A)',
voltage: '230V',
values: [12.2, 13.9].map((v) => v.toFixed(1)),
},
{
- title: 'Power (W)',
+ title: 'Power\n (W)',
voltage: '230V',
values: [2800, 3200],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '230V',
values: [11, 11],
},
{
- title: 'Current (A)',
+ title: 'Current\n (A)',
voltage: '240V',
values: [12.7, 14.5].map((v) => v.toFixed(1)),
},
{
- title: 'Power (W)',
+ title: 'Power\n (W)',
voltage: '240V',
values: [3050, 3500],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '240V',
values: [12, 12],
},
diff --git a/docs/.vuepress/components/TableRound.vue b/docs/.vuepress/components/TableRound.vue
index febb5158..50d653a0 100644
--- a/docs/.vuepress/components/TableRound.vue
+++ b/docs/.vuepress/components/TableRound.vue
@@ -4,80 +4,126 @@ export default {
data: () => ({
values: [
{
- title: '#',
- values: [8, 11, 6, 9, 7, 1, 10, 2, 3, 4, 5],
- },
- {
- title: 'Diameter (cm)',
+ title: 'Name',
+ url: true,
+ values: [
+ {
+ title: 'BPI_008',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-25cm-diameter-5500w',
+ },
+ {
+ title: 'BPI_011',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-25cm-diameter-2800w',
+ },
+ {
+ title: 'BPI_006',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-30cm-diameter-32000w',
+ },
+ {
+ title: 'BPI_009',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-30cm-diameter-5500w',
+ },
+ {
+ title: 'BPI_007',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-35cm-diameter-35000w',
+ },
+ {
+ title: 'BPI_001',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-35cm-diameter-8500w',
+ },
+ {
+ title: 'BPI_010',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-35cm-diameter-5500w',
+ },
+ {
+ title: 'BPI_002',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-40cm-diameter-8500w',
+ },
+ {
+ title: 'BPI_003',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-50cm-diameter-10000w',
+ },
+ {
+ title: 'BPI_004',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-60cm-diameter-10000w',
+ },
+ {
+ title: 'BPI_005',
+ url: 'https://store.brewpi.com/round-heating-element-for-brewing-80cm-diameter-15000w',
+ },
+ ],
+ },
+ {
+ title: 'Diameter\n (cm)',
length: 'cm',
values: [25, 25.5, 30, 30, 35, 35, 35, 40, 50, 60, 80],
},
{
- title: 'Length (cm)',
+ title: 'Length\n (cm)',
length: 'cm',
values: [30, 30.5, 35, 35, 40, 40, 40, 45, 56.5, 66, 86.5],
},
{
- title: 'Min. kettle ⌀ (cm)',
+ title: 'Min. kettle\n ⌀ (cm)',
length: 'cm',
values: [31, 32, 36, 36, 41, 41, 41, 46, 57.5, 67, 87.5],
},
{
- title: 'Designed for kettle ⌀ (cm)',
+ title: 'Designed for\n kettle ⌀ (cm)',
length: 'cm',
values: [35, 35, 40, 40, 45, 45, 45, 50, 63, 72, 93],
},
{
- title: 'Diameter (in)',
+ title: 'Diameter\n (in)',
length: 'inch',
values: [9.8, 10, 11.8, 11.8, 13.8, 13.8, 13.8, 15.7, 19.7, 23.6, 31.5].map((v) => v.toFixed(1)),
},
{
- title: 'Length (in)',
+ title: 'Length\n (in)',
length: 'inch',
values: [11.8, 12, 13.8, 13.8, 15.7, 15.7, 15.7, 17.7, 22.2, 26, 34.1].map((v) => v.toFixed(1)),
},
{
- title: 'Min. kettle ⌀ (in)',
+ title: 'Min. kettle\n ⌀ (in)',
length: 'inch',
values: [12.2, 12.6, 14.2, 14.2, 16.1, 16.1, 16.1, 18.1, 22.6, 26.4, 34.4].map((v) => v.toFixed(1)),
},
{
- title: 'Designed for kettle ⌀ (in)',
+ title: 'Designed for\n kettle ⌀ (in)',
length: 'inch',
values: [13.8, 13.8, 15.7, 15.7, 17.7, 17.7, 17.7, 19.7, 24.8, 28.3, 36.6].map((v) => v.toFixed(1)),
},
{
- title: 'No. Resistors',
+ title: 'No.\n Resistors',
values: [3, 1, 1, 3, 1, 3, 3, 3, 3, 3, 3],
},
{
- title: 'Current per resistor (A)',
+ title: 'Current per\n resistor (A)',
voltage: '230V',
values: [8, 12.2, 15.2, 8, 15.2, 12.3, 8, 12.3, 14.5, 14.5, 21.7].map((v) => v.toFixed(1)),
},
{
- title: 'Total power (W)',
+ title: 'Total power\n (W)',
voltage: '230V',
values: [5500, 2800, 3500, 5500, 3500, 8500, 5500, 8500, 10000, 10000, 15000],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '230V',
values: [6.8, 10.3, 10.7, 5.6, 9.2, 7.5, 4.8, 6.5, 6.1, 5.1, 5.8],
},
{
- title: 'Current per resistor (A)',
+ title: 'Current per\n resistor (A)',
voltage: '240V',
values: [8.3, 12.7, 15.9, 8.3, 15.9, 12.9, 8.3, 12.9, 15.1, 15.1, 22.7].map((v) => v.toFixed(1)),
},
{
- title: 'Total power (W)',
+ title: 'Total power\n (W)',
voltage: '240V',
values: [6000, 3050, 3800, 6000, 3800, 9250, 6000, 9250, 10900, 10900, 16350],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '240V',
values: [7.4, 11.2, 11.7, 6.1, 10, 8.2, 5.2, 7.1, 6.6, 5.6, 6.3].map((v) => v.toFixed(1)),
},
diff --git a/docs/.vuepress/components/TableTriclamp.vue b/docs/.vuepress/components/TableTriclamp.vue
index 0bd47307..904b5980 100644
--- a/docs/.vuepress/components/TableTriclamp.vue
+++ b/docs/.vuepress/components/TableTriclamp.vue
@@ -4,60 +4,86 @@ export default {
data: () => ({
values: [
{
- title: '#',
- values: [14, 11, 15, 16, 12, 13],
+ title: 'Name',
+ url: true,
+ values: [
+ {
+ title: 'BPI_TC_2800',
+ url:'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-30-cm-2800w-in-2-loops-2-inch-clamp-64-mm',
+ },
+ {
+ title: 'BPI_TC_5500',
+ url: 'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-32-cm-5500w-2-inch-clamp-64-mm',
+ },
+ {
+ title: 'BPI_TC_3200',
+ url:'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-35-cm-3200w-in-2-loops-2-inch-clamp-64-mm',
+ },
+ {
+ title: 'BPI_TC_5000',
+ url:'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-42-cm-5000w-in-2-loops-2-inch-clamp-64-mm'
+ },
+ {
+ title: 'BPI_TC_8500',
+ url:'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-42-cm-8500w-in-3-loops-2-inch-clamp-64-mm',
+ },
+ {
+ title: 'BPI_TC_10000',
+ url:'https://store.brewpi.com/tri-clamp-heating-element-for-brewing-52-cm-10000w-in-3-loops-2-inch-clamp-64-mm',
+ }
+ ],
},
{
- title: 'Length (cm)',
+ title: 'Length\n (cm)',
length: 'cm',
values: [30, 32, 35, 42, 42, 52],
},
{
- title: 'Min. kettle ⌀ (cm)',
+ title: 'Min. kettle\n ⌀ (cm)',
length: 'cm',
values: [30, 32, 35, 42, 42, 52],
},
{
- title: 'Length (in)',
+ title: 'Length\n (in)',
length: 'inch',
values: [11.8, 12.6, 13.8, 16.5, 16.5, 20.5].map((v) => v.toFixed(1)),
},
{
- title: 'Min. kettle ⌀ (in)',
+ title: 'Min. kettle\n ⌀ (in)',
length: 'inch',
values: [11.8, 12.6, 13.8, 16.5, 16.5, 20.5].map((v) => v.toFixed(1)),
},
{
- title: 'No. Resistors',
+ title: 'No.\n Resistors',
values: [2, 3, 2, 2, 3, 3],
},
{
- title: 'Current per resistor (A)',
+ title: 'Current per\n resistor (A)',
voltage: '230V',
values: [6.1, 8.0, 7.0, 10.9, 12.3, 14.5].map((v) => v.toFixed(1)),
},
{
- title: 'Total power (W)',
+ title: 'Total power\n (W)',
voltage: '230V',
values: [2800, 5500, 3200, 5000, 8500, 10000],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '230V',
values: [8.8, 10.6, 8.3, 10.3, 11.7, 10.7].map((v) => v.toFixed(1)),
},
{
- title: 'Current per resistor (A)',
+ title: 'Current per\n resistor (A)',
voltage: '240V',
values: [6.4, 8.3, 7.3, 11.3, 12.9, 15.1].map((v) => v.toFixed(1)),
},
{
- title: 'Total power (W)',
+ title: 'Total power\n (W)',
voltage: '240V',
values: [3050, 6000, 3500, 5450, 9250, 10900],
},
{
- title: 'Watt density (W/cm²)',
+ title: 'Watt density\n (W/cm²)',
voltage: '240V',
values: [9.6, 11.5, 9.0, 11.2, 12.7, 11.7].map((v) => v.toFixed(1)),
},
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
index c7b30649..28567a98 100644
--- a/docs/.vuepress/config.js
+++ b/docs/.vuepress/config.js
@@ -20,7 +20,7 @@ module.exports = {
{ text: 'User guides', link: '/user/startup' },
{ text: 'Developer docs', link: '/dev/' },
// Hardware section commented out for update / review Elco
- // { text: 'Hardware', link: '/hardware/' },
+ { text: 'Hardware', link: '/hardware/' },
{ text: 'BrewPi', link: 'https://www.brewpi.com/' },
],
sidebar: {
@@ -131,9 +131,10 @@ module.exports = {
'troubleshooting',
],
// Hardware section commented out for review / update Elco
- // '/hardware/': [
- // 'heating_elements',
- // ],
+ '/hardware/': [
+ 'heating_elements',
+ 'spark_4_user_guide',
+ ],
},
repo: 'brewblox/brewblox-documentation',
docsDir: 'docs',
diff --git a/docs/hardware/README.md b/docs/hardware/README.md
new file mode 100644
index 00000000..ffb957c4
--- /dev/null
+++ b/docs/hardware/README.md
@@ -0,0 +1,2 @@
+# Hardware
+Here you can find our hardware user guides and useful information about what hardware components to select for your brew setup.
\ No newline at end of file
diff --git a/docs/hardware/heating_elements.md b/docs/hardware/heating_elements.md
index 6376e0be..89fc8bd0 100644
--- a/docs/hardware/heating_elements.md
+++ b/docs/hardware/heating_elements.md
@@ -10,7 +10,7 @@ Always consult an electrician for advice and help with wiring your elements. Und
## Heating water
-Heating water takes a lot of energy. For example: with a heating element of 3500W it would take 18 minutes to heat 20L of water to 65C for mashing (20 - 65C), or 32 minutes to boil (20 - 100C). Heating water with this setup adds 50 minutes of waiting time to your brewing day. However, if you were to switch to 50L batches, the waiting time already adds up to more than two hours. Select a higher power heating element when your mains outlet allows. You can calculate the expected heating time in your situation with the calculator below.
+Heating water takes a lot of energy. For example: with a heating element of 3500W it would take 18 minutes to heat 20L of water to 65°C for mashing (20 - 65°C), or 32 minutes to boil (20 - 100°C). Heating water with this setup adds 50 minutes of waiting time to your brewing day. However, if you were to switch to 50L batches, the waiting time already adds up to more than two hours. Select a higher power heating element when your mains outlet allows. You can calculate the expected heating time in your situation with the calculator below.
@@ -44,7 +44,7 @@ Three phase mains connections are the high-power electrical connections outside
The second connection option is the delta configuration. With the exception of Norway, our heating elements should **never** be connected in delta configuration as it will fry your element.
-**Delta configuration:** in a three phase delta configuration the individual heating elements are connected between two adjacent phases. For example: element 1 is connected between L1 and L2, element two between L2 and L3, etc. The voltage over each element is 400V AC. Our heating elements are dimensioned to operate at 230 - 240 V AC, operation at 400V AC draws too much current (power) and is unsafe. Our heating elements *cannot* be used in three phase delta configuration. **Exception:** in some parts of Norway electrical power is distributed over three phase connections with a voltage of 230V AC phase to phase (instead of 400V AC). In this case connecting your element in delta configuration is safe.
+**Delta configuration:** in a three phase delta configuration the individual heating elements are connected between two adjacent phases. For example: element 1 is connected between L1 and L2, element two between L2 and L3, etc. The voltage over each element is 400V AC. Our heating elements are dimensioned to operate at 230 - 240V AC, operation at 400V AC draws too much current (power) and is unsafe. Our heating elements *cannot* be used in three phase delta configuration. **Exception:** in some parts of Norway electrical power is distributed over three phase connections with a voltage of 230V AC phase to phase (instead of 400V AC). In this case connecting your element in delta configuration is safe.
@@ -103,8 +103,6 @@ Foldback heating elements are straight elements fold back, hence the name. The f
-TODO: XX BrewPi part. no. nog invullen
-
#### Mounting kit
The basic design of these foldback elements does not provide a protective earth terminal, nor a cover for the wiring. To overcome these deficiencies we have designed a custom mounting kit, see photos below. The mounting kit is sold separately, and can be found in the [store](https://store.brewpi.com/mashing/stainless-steel-heating-elements/heating-element-mounting-kit). With the mounting kit installed your element and kettle are grounded, and the wiring is safe from liquids.
@@ -136,9 +134,9 @@ To connect an heating element to a single phase outlet requires connecting three
**Examples:**
-- Round heating element [#7](#round) has one resistor and draws a current of 15.2A when connected to a 230V outlet.
-- Tri-clamp element [#14](#tri-clamp) has two resistors and draws a current of 6.1A per resistor at 230V. When connected in parallel to a 230V single phase outlet the element will draw a current of 2 x 6.1 = 12.2A.
-- Round heating element [#2](#round) has three resistors and draws a current of 12.3A per resistor at 230V. When connected in parallel to a 230V single phase outlet the element will draw a current of 3 x 12.3 = 36.9A.
+- Round heating element [BPI_007](#round) has one resistor and draws a current of 15.2A when connected to a 230V outlet.
+- Tri-clamp element [BPI_TC_2800](#tri-clamp) has two resistors and draws a current of 6.1A per resistor at 230V. When connected in parallel to a 230V single phase outlet the element will draw a current of 2 x 6.1 = 12.2A.
+- Round heating element [BPI_002](#round) has three resistors and draws a current of 12.3A per resistor at 230V. When connected in parallel to a 230V single phase outlet the element will draw a current of 3 x 12.3 = 36.9A.
The wires connected to your element should be of sufficient diameter to transport the current, and the current should not exceed the maximum current of your circuit breaker. More about wire diameter [here](#wire-gauge).
@@ -155,7 +153,7 @@ Connecting a 3 resistor element to a three phase outlet requires connecting 5 wi
**Example:**
-- Round heating element [#4](#round) has three resistors and draws a current of 14.5A per phase when connected to a 230V three phase outlet.
+- Round heating element [BPI_004](#round) has three resistors and draws a current of 14.5A per phase when connected to a 230V three phase outlet.
The wires connected to your element should be of sufficient diameter to transport the current, and the current should not exceed the maximum current of your circuit breaker. More about wire diameter in the next section.
@@ -189,7 +187,7 @@ TODO: Elco foto maken vervlakte ketelwand.
## Operation
-In your brewing setup, the heating element will be used to ramp up the temperature of the mash / wort and keep it there for some time dependent on your receipt. For instance during mashing you typically want your mash temperature somewhere in the region of 65C (150F) for some 10s of minutes. To keep the mash at a steady temperature we will switch the element on for short periods of time to reduce its effective power. This technique is called Pulse Width Modulation (PWM). In this section we will show you what hardware you need, and how to connect it to your element and mains. The remainder of the control loop requires a controller and a temperature sensor. For the controller you can use the [BrewPi Spark](https://store.brewpi.com/temperature-control/brewpi-spark-3), temperature sensors can be found in the [store](https://store.brewpi.com/temperature-control/temperature-sensors).
+In your brewing setup, the heating element will be used to ramp up the temperature of the mash / wort and keep it there for some time dependent on your receipt. For instance during mashing you typically want your mash temperature somewhere in the region of 65C (150F) for some 10s of minutes. To keep the mash at a steady temperature we will switch the element on for short periods of time to reduce its effective power. This technique is called Pulse Width Modulation (PWM). In this section we will show you what hardware you need, and how to connect it to your element and mains. The remainder of the control loop requires a controller and a temperature sensor. For the controller you can use the [Brewblox Spark](https://store.brewpi.com/temperature-control/brewpi-spark-3), temperature sensors can be found in the [store](https://store.brewpi.com/temperature-control/temperature-sensors).
TODO - Elco: herschrijven.
diff --git a/docs/hardware/readme.md b/docs/hardware/readme.md
deleted file mode 100644
index f19f6d8a..00000000
--- a/docs/hardware/readme.md
+++ /dev/null
@@ -1 +0,0 @@
-Here you can find useful information about what hardware components to select for your brew setup.
\ No newline at end of file
diff --git a/docs/hardware/spark_4_user_guide.md b/docs/hardware/spark_4_user_guide.md
new file mode 100644
index 00000000..bd1b0dec
--- /dev/null
+++ b/docs/hardware/spark_4_user_guide.md
@@ -0,0 +1,237 @@
+# Brewblox Spark 4 and 1-Wire GPIO module user guide
+
+
+
+## Getting started
+
+### General description
+Welcome to the Brewblox Spark 4 and 1-Wire general-purpose I/O (GPIO) module user guide. Thank you for your purchase!
+With the Brewblox Spark 4, our I/O modules and the Brewblox software you are ready to take (home) brewing to the next level.
+**TODO** Nog wat meer inleiding over de Spark 4?
+
+This guide will provide you with a quick overview of the hardware installation process of the Spark 4 and 1-Wire GPIO module.
+
+Happy brewing!
+
+**TODO Geke, Bob, Felix and Elco, of Team Brewblox, of Elco Jacobs? wat zou je hier willen?**
+
+### What’s in the box
+Your Spark 4 will come shipped with the following components.
+
+1x Spark 4
+
+1x DIN rail bracket (optional)
+![Spark-4-DIN-rail-adapter]()
+1x 3,5 inch 320x420 pixels TFT LCD Color Display enclosure (optional)
+
+
+Your 1-Wire GPIO module will come shipped with the following components.
+
+1x 1-Wire GPIO module
+
+1x 1-Wire GPIO module enclosure (optional)
+
+5x Actuator connectors
+![Actuator-connector]()
+1x DIN rail bracket (optional)
+![1-Wire-GPIO-module-DIN-rail-adapter]
+
+When you unpack please ensure you check everything is there, and if any parts are missing please contact us immediately.
+
+### Assembly
+When ordering a Spark 4 with one I/O module, the product comes pre-assembled. But if you order more than one I/O module or if you ever remove/add an I/O module you need to connect them yourself.
+To do this you can follow the next steps:
+
+1. Make sure your Spark 4 and I/O module(s) are disconnected from the power supply.
+2. Remove the protection cap from the I/O module(s) Board-to-Board connector pins.
**DO NOT** touch the Board-to-Board connector pins!
+3. Plug the I/O module into the Spark 4, by gently pushing the pins on the I/O module into the Board-to-Board connection on the bottom of the Spark 4.
+4. If you have more than one I/O module, you can stack them by gently pushing the pins into the Board-to-Board connection on the bottom of the previous I/O module. To stack them in a neat way, make sure you turn the I/O modules 180 degrees (see photo's below). You can stack up to four I/O modules onto a Spark 4.
+
+
+
+
+
+
+## How to use the product
+
+### Connecting with the Brewblox software
+Your Brewblox Spark 4 is ready to be added to the Brewblox software now.
+
+If you want more information about how to add a Spark 4 to the Brewblox software you can use our [guide](https://www.brewblox.com/user/startup.html#step-5-flash-the-firmware)
+
+If you want to use more than one Spark 4, you can find a guide [here](https://www.brewblox.com/user/adding_spark.html)
+
+We also have a guide available about how to install the Brewblox software on your server. You can find the guide [here](https://www.brewblox.com/user/startup.html)
+
+### Plug in the power supply
+- *USB-C:* Connect the USB-C cable to the USB port on the Spark 4, and plug the other side of the cable into a suitable adapter or the server.
+- *Passive PoE:* Plug in the ethernet cable. Make sure the switch on the other end of the ethernet cable supports Passive PoE, or use a Passive PoE injector.
**WARNING** With Passive PoE the power is always on! Do not plug the ethernet cable in an other device than the Spark 4 when using Passive PoE. This may cause damage to the other device!
+- *I/O connector for power supply:* Connect the actuator plug with the power supply cable, then plug the actuator plug in the separated 2-pin GPIO block. **TODO** meer uitleg geven hoe dit in zijn werk gaat.
+
+### Turning on the Spark 4
+When the Spark 4 has power it turns itself on. The OK and R buttons should start blinking in cyan and blue, and you should hear a ‘beep’.
+
+### Turning off the Spark 4
+To turn the Spark 4 off, you have to cut the power supply.
+
+### Rebooting the Spark 4
+Press the R button to reboot the Spark 4. When successful you should hear a ‘beep’.
+
+### Connection with your network
+You can use either Wi-Fi or a LAN (Ethernet) cable to connect your Spark 4 to your network.
+
+#### Ethernet
+Plug in the LAN (Ethernet) cable to connect your Spark 4 to the ethernet network. Make sure that the other end of your Ethernet cable is connected to a functioning switch. To remove the LAN (Ethernet) cable you have to use the lever on the enclosure of the Spark 4.
+
+#### Wi-Fi
+1. Install the ESP BLE Provisioning app for [Android](https://play.google.com/store/apps/details?id=com.espressif.provble) or ESP SoftAP Provisioning app for [iOS](https://apps.apple.com/in/app/esp-softap-provisioning/id1474040630) on your mobile phone.
+2. Open the app on your mobile phone.
+3. Scan the QR code shown on the display of your Spark 4, or provided with your Spark 4.
+4. Follow the instructions in the app. The app will ask for Wi-Fi credentials and send them to the ESP32 over BLE.
+5. If succeeded, you can see your IP adress in the upper left corner of the display.
+
+### Inserting your Micro-SD card
+Insert your Micro-SD card in the Micro-SD slot. The Micro-SD card is inserted label side up. The Micro-SD slot is located on the lower side of the Spark 4.
+
+## Compatibility
+The 1-Wire GPIO module lets you plug in 4 of **our** temperature sensors, using DS18B20. We **cannot** guarantee other 1-Wire sensors will work, because 1-Wire is not a standardized protocol.
+The 1-Wire GPIO module also has two green terminal blocks, a block of 8 pins and a block of 2 pins. The 2-pin block can be used for external power at 12V or 24V.
+The 8-pin terminal block is for GPIO. For each 1-Wire GPIO module, you can configure whether I/O should be at 5V or the external input voltage (12V or 24V).
+
+Each of the 8 GPIO pins is a configurable half H-bridge with fault detection. Which means that each pin can be one of the following:
+- Positive supply voltage (5V or external input voltage)
+- Negative supply voltage (GND, 0V)
+- A low-side switch
+- A high-side switch
+- A push-pull bidirectional pin
+- A digital input
+
+Some examples of what you can connect are:
+- A solid-state relay (SSR) or a mechanical relay: 1 high side switch and a GND pin.
+- A fan: a GND pin and a high-side switch.
+- A bidirectional motor or valve: 2 push-pull pins.
+- A switch: a digital input and a GND pin.
+
+If you have valves that automatically close when they lose power, you can even use all pins as a high-side switch to connect eight valves to the board and connect GND to them externally. Each pin can source or sink up to 1A, but multiple pins can be combined if you need more current. All pins also support individual PWM for speed/intensity control.
+
+The 1-Wire GPIO module is **not** compatible with thermocouples and RTDs like a PT-100 or PT-1000.
+
+**TODO** aanvullen waar wel/niet mee compatible bv. boards, sensoren, valves etc.
+
+## Maintenance
+
+### Spark 4 and I/O module(s)
+When dirty, you can clean the enclosure of the Spark 4 and I/O module(s) with a dry or damp cloth.
+The Spark and I/O module(s) and enclosures are not waterproof, so do not use a wet cloth or immerse them in water.
+
+When you use the Spark or I/O module(s) without enclosure we advise you to use compressed air.
+
+### Touchscreen
+It is best to first attempt to clean with a dry microfiber cloth. Wipe the screen using a circular motion with slight pressure. There should not be a need to press hard on the display.
+If the touchscreen still has dirt, dampen a microfiber cloth with a cleaning solution specifically designed for touchscreens and gently rub the spots away. Always moisten the cloth rather than spraying cleaner directly onto the touchscreen to prevent water damage.
+Never use bleach, ammonia or other abrasive cleaners to clean the touchscreen. Always give the touchscreen a moment to completely dry before using.
+
+## Repair
+In case your Spark 4 might break or stops working properly we strongly recommend contacting us. For more information about our warranty, see below.
+The only part you can replace yourself, is the touchscreen.
+
+### Replacing the screen
+To replace the touchscreen you can follow the next instructions.
+
+1. Disconnect the Spark 4 and I/O module(s) from the power supply.
+2. Remove the I/O module(s) from the Spark 4.
+3. Remove the screen placement enclosure from the Spark 4, by gently pulling the right side of the screen placement enclosure outside and forwards.
+4. Unlock the cable that connects the screen to the board by clicking the lever that holds the cable upwards.
+5. Now you can remove the screen.
+6. Place the new screen and follow the previous steps backwards to install the screen and enclosure again.
+
+## How to dispose of the product
+
+### Disposal of electronic components
+Please protect our environment by properly disposing of the Brewblox Spark 4 and/or the I/O module(s). Electronic devices should not be disposed of as household refuse. For EU customers, Brewblox offers a product take-back service. When your product(s) reach the end of their life, simply send them back to us at your expense, we will dispose of them according to the relevant legislation. If you live outside the European Union and wish to discard this product please contact your local authorities and ask for the correct method of disposal.
+
+### Disposal of packaging waste
+Packaging materials of the product are manufactured from recyclable materials. Dispose of them properly and sort them in accordance with recycled waste instructions. Do not dispose of them with normal domestic waste.
+
+## Troubleshooting
+We are happy to help with any problems or questions that arise when using the Brewblox Spark 4, I/O module(s) or our Brewblox software. The most common problems are answered below.
+For more information, other problems or questions we advise you to check our website first. If that doesn’t solve your problem or question you can reach us on our forum.
+
+### What happens when connecting more than four I/O modules?
+The Spark 4 supports up to four I/O modules. When you connect more than four modules, the fifth module will overwrite the board address from the first module. The sixth module will overwrite the address from the second module, etc. This can result in conflicts between the boards, and the Spark 4 might stop working properly.
+
+### Wi-Fi not working: is the Spark connected to Wi-Fi?
+If the Spark LCD does not show an IP address, you can try to reset the Wi-Fi first.
+
+#### Reset Wi-Fi
+1. Push the reset button on the Spark 4.
+2. When restarting push the OK button on the Spark 4 for 5 seconds.
+
+### Wi-Fi not working: is the Spark accessible from your computer and the server?
+Can you visit the Spark IP in your browser? It should show a short placeholder message.
+If you run `brewblox-ctl http get `, do you see the html for the placeholder message?
+
+If the answer to either is no, your Spark and server are likely using different subnets in your home network. Check your router configuration to allow them to communicate.
+
+If the answer to both questions is yes, but the service still can't find your Spark, it may be a problem with mDNS. By default, we use [multicast DNS](https://en.wikipedia.org/wiki/Multicast_DNS) to discover Sparks that are not connected over USB. In most - but not all - routers, mDNS is enabled by default. Check your router configuration for settings related to multicast DNS.
+
+If you can't solve the problem in your router settings, it may be preferable to skip discovery, and add `--device-host=SPARK_IP` to your docker-compose.yml file. You can find the syntax in the [connection settings guide](../user/connect_settings).
+When doing so, it is advised to assign a fixed IP address to the Spark in your router settings. (Also called "static DHCP lease").
+
+### How do I display the temperature in Fahrenheit?
+This can be set separately for the Spark service.
+1. Go to the Spark service page
+2. In the top right corner, click on the Actions button (three vertical dots).
+3. Click on `Configure used units`, and set desired values for the UI and the Spark display.
+
+## Safety instructions
+- Read all instructions before using the Brewblox Spark 4 and I/O module(s).
+- Do not touch the Board-to-Board connector pins on the I/O module(s).
+- To protect against fire, electric shock and injury, do not immerse the Brewblox Spark 4, I/O module(s) or plugs in water or other liquid.
+- The Brewblox Spark 4 and I/O module(s) are not intended for use by young children or infirm persons without supervision.
+- Do not use the Brewblox Spark 4 and I/O module(s) for anything other than the intended use.
+- Do not plug in the ethernet cable to an other device than the Spark 4 when using Passive PoE. This may cause damage to the other device!
+- Please ensure that the system is completely disconnected from the electrical supply before attempting to remove or replace any parts or I/O modules.
+- Do seek expert advice if you are at all unsure about the safety of your electrical installation.
+- Do not scratch hard objects against the display as this may cause damage.
+- Save these instructions for future reference.
+- **TODO** Iets over de power supply aansluiting, of max power?
+
+**NOTE** Not following the safety instructions above could result in injuries and may void your product’s warranty.
+
+## Technical specifications
+
+### Brewblox Spark 4
+
+| Feature | Brewblox Spark 4 |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------:|
+| Product Dimensions | 66 x 58 x 11 mm without screen and enclosure
99 x 61.5 x 20 mm with screen and enclosure |
+| Product Weight | 21g without screen and enclosure
82g with screen and enclosure |
+| Power Supply Input | USB-C, Passive PoE or through the Board-to-Board connector |
+| Power Supply Output | ...V through the Board-to-Board connector |
+| Ports | 1x USB-C
1x 100 Mbps ethernet
1x Micro-SD
1x Board-to-Board connector with pins for I2C, SPI, UART, and GPIO |
+| WiFi | 802.11b/g/n; 802.11n up to 150 Mbps |
+| Bluetooth | Bluetooth V4.2 BR/EDR and Bluetooth LE |
+| Limited Lifetime Warranty| Yes, 2 years |
+| Product Compliance | CE |
+| Country of Manufacture | The Netherlands |
+
+### 1-Wire GPIO Module
+
+| Feature | 1-Wire GPIO module |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------:|
+| Product Dimensions | 66 x 58 x 17 mm without enclosure
68 x 63 x 20 mm with enclosure |
+| Product Weight | 30g without enclosure
50g with enclosure |
+| Power Supply Input | 12V or 24V GPIO pin input or ...V through the Board-to-Board connector |
+| Power Supply Output | 5, 12 or 24V through the GPIO pins
...V through the Board-to-Board connector |
+| Ports | 8x GPIO pin
2x GPIO pin for power supply
4x RJ12
2x Board-to-Board connector with pins for I2C, SPI, UART, and GPIO|
+| Limited Lifetime Warranty| Yes, 2 years |
+| Product Compliance | CE |
+| Country of Manufacture | The Netherlands |
+
+## Warranty
+Brewblox warrants this product/these products to be free from defects in workmanship and materials, under normal use and conditions, for a period of two (2) years from the original invoice date. Shipping and handling fees are to be paid for by the customer. To obtain warranty service, you must have a return authorization. To request a return authorization, you can contact us.
+
+Brewblox agrees, at its option during the warranty period, to repair any defect in material or workmanship or to furnish a repaired or refurbished product in exchange without charge (except for a fee for shipping which will be incurred by the customer). Such repair or replacement is subject to verification of the defect or malfunction and proof of purchase.
+
+This limited warranty does not cover damage of the product resulting from negligence, unauthorized modification or misuse of the product.
\ No newline at end of file
diff --git a/docs/images/spark4/1-Wire-GPIO-right-stacking.jpg b/docs/images/spark4/1-Wire-GPIO-right-stacking.jpg
new file mode 100644
index 00000000..e575a0f8
Binary files /dev/null and b/docs/images/spark4/1-Wire-GPIO-right-stacking.jpg differ
diff --git a/docs/images/spark4/1-Wire-GPIO-wrong-stacking.jpg b/docs/images/spark4/1-Wire-GPIO-wrong-stacking.jpg
new file mode 100644
index 00000000..92e580f6
Binary files /dev/null and b/docs/images/spark4/1-Wire-GPIO-wrong-stacking.jpg differ
diff --git a/docs/images/spark4/1-Wire-module-PCB.jpg b/docs/images/spark4/1-Wire-module-PCB.jpg
new file mode 100644
index 00000000..69997725
Binary files /dev/null and b/docs/images/spark4/1-Wire-module-PCB.jpg differ
diff --git a/docs/images/spark4/1-Wire-module-casing.jpg b/docs/images/spark4/1-Wire-module-casing.jpg
new file mode 100644
index 00000000..6bd4431f
Binary files /dev/null and b/docs/images/spark4/1-Wire-module-casing.jpg differ
diff --git a/docs/images/spark4/Spark4-1-Wire-module-casing.jpg b/docs/images/spark4/Spark4-1-Wire-module-casing.jpg
new file mode 100644
index 00000000..44032143
Binary files /dev/null and b/docs/images/spark4/Spark4-1-Wire-module-casing.jpg differ
diff --git a/docs/images/spark4/Spark4-1-Wire-module.jpg b/docs/images/spark4/Spark4-1-Wire-module.jpg
new file mode 100644
index 00000000..17f9d89e
Binary files /dev/null and b/docs/images/spark4/Spark4-1-Wire-module.jpg differ
diff --git a/docs/images/spark4/Spark4-PCB.jpg b/docs/images/spark4/Spark4-PCB.jpg
new file mode 100644
index 00000000..0582f53c
Binary files /dev/null and b/docs/images/spark4/Spark4-PCB.jpg differ
diff --git a/docs/images/spark4/Spark4-casing.jpg b/docs/images/spark4/Spark4-casing.jpg
new file mode 100644
index 00000000..149eaab8
Binary files /dev/null and b/docs/images/spark4/Spark4-casing.jpg differ
diff --git a/docs/images/spark4/Spark4-right-stacking.jpg b/docs/images/spark4/Spark4-right-stacking.jpg
new file mode 100644
index 00000000..16b982ec
Binary files /dev/null and b/docs/images/spark4/Spark4-right-stacking.jpg differ
diff --git a/docs/images/spark4/Spark4-wrong-stacking.jpg b/docs/images/spark4/Spark4-wrong-stacking.jpg
new file mode 100644
index 00000000..b79160be
Binary files /dev/null and b/docs/images/spark4/Spark4-wrong-stacking.jpg differ