Skip to content

[PC-1396] Edge Control User Manual #2176

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 48 commits into from
Sep 19, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
569ddab
User Manual Folder created
mcmchris Sep 19, 2023
eb37a03
User Manual writing commit 1
mcmchris Sep 19, 2023
1f95891
Typo fix
mcmchris Sep 19, 2023
78e1552
User Manual writing commit 2
mcmchris Sep 19, 2023
75217f4
User Manual writing commit 3
mcmchris Sep 20, 2023
fcf731b
User Manual writing commit 4
mcmchris Sep 20, 2023
03f05b1
Images order change
mcmchris Sep 21, 2023
3c86be6
User Manual writing commit 5
mcmchris Sep 21, 2023
286ae85
User Manual writing commit 6
mcmchris Sep 21, 2023
63f9e25
User Manual writing commit 7
mcmchris Sep 21, 2023
2de52e2
User Manual writing commit 8
mcmchris Sep 25, 2023
ad925bf
User Manual writing commit 9
mcmchris Sep 25, 2023
981dc34
User Manual writing commit 10
mcmchris Sep 26, 2023
1235dfc
User Manual writing commit 11
mcmchris Sep 27, 2023
847b169
User Manual writing commit 12
mcmchris Sep 28, 2023
ef80511
Typo Fix
mcmchris Sep 28, 2023
9b00ef0
User Manual writing commit 13
mcmchris Sep 29, 2023
a204411
User Manual writing commit 14
mcmchris Oct 1, 2023
2a69cce
User Manual writing commit 15
mcmchris Oct 2, 2023
0931f88
User Manual writing commit 16
mcmchris Oct 2, 2023
e92e598
User Manual writing commit 17
mcmchris Oct 2, 2023
34cf055
User Manual writing commit 18
mcmchris Oct 2, 2023
0b6adef
User Manual writing commit 19
mcmchris Oct 3, 2023
0633987
User Manual writing commit 20
mcmchris Oct 3, 2023
adcf89b
User Manual writing commit 21
mcmchris Oct 3, 2023
c14d841
Final commit 22
mcmchris Oct 3, 2023
77cbfe2
Typos fix 1
mcmchris Oct 3, 2023
bb92359
Typos fix 2
mcmchris Oct 3, 2023
782d985
Typos fix 3
mcmchris Oct 3, 2023
7edf283
Typos fix 4
mcmchris Oct 3, 2023
5591243
Punctuation fix 1
mcmchris Oct 3, 2023
1d570fb
Rephrase fix 1
mcmchris Oct 3, 2023
f2cafdd
Typos fix 5
mcmchris Oct 3, 2023
b323fcf
Structure fix 1
mcmchris Oct 3, 2023
c547763
Gif size update
mcmchris Oct 3, 2023
b50ee27
Checking if spell fixes worked
mcmchris Oct 4, 2023
24bee1d
Edge Control Forum URL fixed
mcmchris Oct 4, 2023
acbb95d
Simple Pinout update
mcmchris Nov 20, 2023
466e33a
Tables update
mcmchris Nov 20, 2023
e32b6d5
I2C section extended
mcmchris Nov 20, 2023
c41a264
Metadata update to see preview
mcmchris Jan 24, 2024
898649a
Metadata update to see preview
mcmchris Jan 24, 2024
2ada41c
Merge branch 'main' into mcmchris/edge-control/user-manual
mcmchris Sep 16, 2024
962ab70
Merge branch 'main' into mcmchris/edge-control/user-manual
mcmchris Sep 16, 2024
bb192b2
Author name updated
mcmchris Sep 16, 2024
e03dd55
Taddy suggested changes 1
mcmchris Sep 17, 2024
f1f9894
Taddy review applied
mcmchris Sep 17, 2024
1d46666
Library note
mcmchris Sep 17, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
User Manual writing commit 12
  • Loading branch information
mcmchris committed Sep 28, 2023
commit 847b169fd73d5d0030a212aedf6cde3eb87075d1
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -753,11 +753,129 @@ MEASURES - Median: 1891.00Ω - Average: 1884.95Ω - Lowest: 1815.00Ω - Highest:

## Outputs
### Latching Outputs
### Latching Commands
### Relay Contacts

The latching outputs are suitable for latching devices like motorized valves and latching solenoid valves. They consists of dual channels (P and N) through which an impulse or strobe can be sent in either of the 2 channels (to open a close valve for example). The duration of the strobes can be configured to adjust to the external device requirement.

![Latching solenoid valve control strobe](assets/solenoid-valve.png)
![Motorized ball valve control strobe](assets/motorized-valve.png)

The board provides a total of 16 latching ports divided in 2 types:

- **8 Latching Outputs** with mosfet drivers, mapped as follows:

| **Output Name** | **Arduino Pin Mapping** |
|:----------------------------:|:-----------------------------------:|
| `Latching Output 1` | `LATCHING_OUT_1` |
| `Latching Output 2` | `LATCHING_OUT_2` |
| `Latching Output 3` | `LATCHING_OUT_3` |
| `Latching Output 4` | `LATCHING_OUT_4` |
| `Latching Output 5` | `LATCHING_OUT_5` |
| `Latching Output 6` | `LATCHING_OUT_6` |
| `Latching Output 7` | `LATCHING_OUT_7` |
| `Latching Output 8` | `LATCHING_OUT_8` |

These outputs can handle up to 3.3 A, so they can manage loads directly without problem. Motorized valves or solenoid latching valves are perfect examples of devices to control with these outputs.

With the following command you can control the output state:

```arduino
Latching.channelDirection(LATCHING_OUT_1, POSITIVE); //this define the output and channel (P or N) that will be controlled
Latching.strobe(200); //this define the time the output is activated.
```

![3-wire motorized ball valve connection](assets/motorized-connection.png)

If you want to know more about using this outputs, follow our guide: [Connecting and Controlling a Motorized Ball Valve](https://docs.arduino.cc/tutorials/edge-control/motorized-ball-valve).

- **8 Latching Commands** without drivers, mapped as follows:

| **Output Name** | **Arduino Pin Mapping** |
|:----------------------------:|:-----------------------------------:|
| `Latching Command 1` | `LATCHING_CMD_1` |
| `Latching Command 2` | `LATCHING_CMD_2` |
| `Latching Command 3` | `LATCHING_CMD_3` |
| `Latching Command 4` | `LATCHING_CMD_4` |
| `Latching Command 5` | `LATCHING_CMD_5` |
| `Latching Command 6` | `LATCHING_CMD_6` |
| `Latching Command 7` | `LATCHING_CMD_7` |
| `Latching Command 8` | `LATCHING_CMD_8` |

These outputs must be connected to external devices through third-party protection/power circuits with high impedance inputs (max +/- 25 mA). They are suitable for custom applications where just the activation signal is needed. For example for using external relay modules or direct connections with other control devices like PLC inputs.

With the following command you can control the output state:

```arduino
Latching.channelDirection(LATCHING_CMD_1, NEGATIVE); //this define the output and channel (P or N) that will be controlled
Latching.strobe(200); //this define the time the output is activated.
```
![LED pilots wired to latching command outputs](assets/latching-cmd.png)

The example code shown below activates the first channel `Latching Outputs` and `Latching Commands` for a defined time (strobe) in a secuence:

This example code could also be found on **File > Examples > Arduino_EdgeControl > Basic > Latching**

```arduino
#include <Arduino_EdgeControl.h>

void setup()
{
Serial.begin(9600);

auto startNow = millis() + 2500;
while (!Serial && millis() < startNow)
;

delay(1000);
Serial.println("Hello, Challenge!");

Latching.begin();
}

void loop()
{
Latching.channelDirection(LATCHING_CMD_1, POSITIVE);
Latching.strobe(2000); // 2 seconds with a 12v output on latching cmd output P

Latching.channelDirection(LATCHING_CMD_1, NEGATIVE);
Latching.strobe(2000); // 2 seconds with a 12v output on latching cmd output N

Latching.channelDirection(LATCHING_OUT_1, POSITIVE);
Latching.strobe(4000); // 4 seconds with a 12v output on latching output P (opening the motorized valve)

Latching.channelDirection(LATCHING_OUT_1, NEGATIVE);
Latching.strobe(4000); // 4 seconds with a 12v output on latching output N (closing the motorized valve)

delay(1000);
}
```

### Relay Outputs

The Edge Control has **four solid state relay outputs**, mapped as follows:

| **Output Name** | **Arduino Pin Mapping** |
|:--------------------------------:|:-------------------------------------:|
| `Solid State Relay 1` | `RELAY_CH01` |
| `Solid State Relay 2` | `RELAY_CH02` |
| `Solid State Relay 3` | `RELAY_CH03` |
| `Solid State Relay 4` | `RELAY_CH04` |

This relay outputs are suitable for AC loads with a current draw below 2.5A and a 24V AC power supply.

You can control the relay outputs individually using this function:

```arduino
Relay.on(RELAY_CH01); // this command closes the channel 1 relay contacts
```
```arduino
Relay.off(RELAY_CH01); // this command opens the channel 1 relay contacts
```
![AC load wiring through channel 1 relay contact](assets/relay-outputs.png)

### Power Outputs

## Edge Control Enclosure Kit

## RTC

## Communication