diff --git a/docs/assets/DigitalInputMachineControl.png b/docs/assets/DigitalInputMachineControl.png new file mode 100644 index 00000000..211d3324 Binary files /dev/null and b/docs/assets/DigitalInputMachineControl.png differ diff --git a/docs/assets/WAGO750_402_coupler.JPG b/docs/assets/WAGO750_402_coupler.JPG new file mode 100644 index 00000000..7e12a96d Binary files /dev/null and b/docs/assets/WAGO750_402_coupler.JPG differ diff --git a/docs/assets/WAGO750_402_discovery.png b/docs/assets/WAGO750_402_discovery.png new file mode 100644 index 00000000..dd38c139 Binary files /dev/null and b/docs/assets/WAGO750_402_discovery.png differ diff --git a/docs/assets/WAGO750_402_end_modul.JPG b/docs/assets/WAGO750_402_end_modul.JPG new file mode 100644 index 00000000..6d08bb0f Binary files /dev/null and b/docs/assets/WAGO750_402_end_modul.JPG differ diff --git a/docs/assets/WAGO750_402_ethernet.JPG b/docs/assets/WAGO750_402_ethernet.JPG new file mode 100644 index 00000000..2ba95f22 Binary files /dev/null and b/docs/assets/WAGO750_402_ethernet.JPG differ diff --git a/docs/assets/WAGO750_402_machinecontrol1.png b/docs/assets/WAGO750_402_machinecontrol1.png new file mode 100644 index 00000000..ddbdf2f8 Binary files /dev/null and b/docs/assets/WAGO750_402_machinecontrol1.png differ diff --git a/docs/assets/WAGO750_402_machinecontrol2.png b/docs/assets/WAGO750_402_machinecontrol2.png new file mode 100644 index 00000000..c7fc0fb4 Binary files /dev/null and b/docs/assets/WAGO750_402_machinecontrol2.png differ diff --git a/docs/assets/WAGO750_402_machinedetected.png b/docs/assets/WAGO750_402_machinedetected.png new file mode 100644 index 00000000..1f1790af Binary files /dev/null and b/docs/assets/WAGO750_402_machinedetected.png differ diff --git a/docs/assets/WAGO750_402_power_terminal.JPG b/docs/assets/WAGO750_402_power_terminal.JPG new file mode 100644 index 00000000..b7a9226a Binary files /dev/null and b/docs/assets/WAGO750_402_power_terminal.JPG differ diff --git a/docs/assets/WAGO750_402_schematic.png b/docs/assets/WAGO750_402_schematic.png new file mode 100644 index 00000000..95c792f1 Binary files /dev/null and b/docs/assets/WAGO750_402_schematic.png differ diff --git a/docs/assets/WAGO750_402_serserial.png b/docs/assets/WAGO750_402_serserial.png new file mode 100644 index 00000000..cd7751e9 Binary files /dev/null and b/docs/assets/WAGO750_402_serserial.png differ diff --git a/docs/assets/WAGO750_402_setmachine.png b/docs/assets/WAGO750_402_setmachine.png new file mode 100644 index 00000000..7b0def80 Binary files /dev/null and b/docs/assets/WAGO750_402_setmachine.png differ diff --git a/docs/assets/WAGO750_402_switch.JPG b/docs/assets/WAGO750_402_switch.JPG new file mode 100644 index 00000000..54cf7ffd Binary files /dev/null and b/docs/assets/WAGO750_402_switch.JPG differ diff --git a/docs/assets/WAGO750_402_terminal.JPG b/docs/assets/WAGO750_402_terminal.JPG new file mode 100644 index 00000000..bd3fe37b Binary files /dev/null and b/docs/assets/WAGO750_402_terminal.JPG differ diff --git a/docs/developer-docs/minimal-example-wago750-402.md b/docs/developer-docs/minimal-example-wago750-402.md index 04ec1c3d..89978c96 100644 --- a/docs/developer-docs/minimal-example-wago750-402.md +++ b/docs/developer-docs/minimal-example-wago750-402.md @@ -1,4 +1,7 @@ -# Minimal Example — Digital Input WAGO750-402 +# Minimal Example — LED Control on the WAGO750-402 +A complete hardware + software walkthrough + +--- ## Table of Contents 1. [Introduction](#1-introduction) @@ -8,22 +11,36 @@ 5. [Demo](#5-demo) 6. [References](#6-references) -## 1. Introduction +--- +## 1. Introduction +The WAGO 750-402 Display Example is a minimal demonstation showing how to display the digital inputs on a WAGO 750-402 EtherCAT terminal using the QiTechmachine framework. +It represents the simplest possible hardware interaction in the system: +Displayung the LED Inputs using the QiTech Control Dashboard. ## 2. Requirements ### Hardware -- WAGO 750-354, -- WAGO 750-602, -- WAGO 750-402, -- WAGO 750-600 -- WAGO 750-1506 +- WAGO **2787-2144 EtherCAT** +- WAGO **750-354 EtherCAT Coupler** +- WAGO **750-602 EtherCAT Power Terminal** +- WAGO **750-402 EtherCAT Terminal** (4.channle digital input) +- WAGO **750-600 EtherCAT Endmodule** +- WAGO **852-1322 Ethernet-Switch** +- **24V DC Lab power supply**(AC/DC adapter) +- A **Linux PC** (Ubuntu/Debian recommended) +- Standard Ethernet cable +- Flat screwdriver + + + +--- ### Software *(Installation steps in Section 4)* - Rust tollchain - Node-js + npm +- Git - QiTech Control repository - EtherCAT HAL *(include inside repo)* @@ -31,6 +48,10 @@ ### 3.1 Schematic +![](../assets/WAGO750_402_schematic.png) + +--- + #### ⚠️ Safety Warning Always disconnect power before wiring. Working on live EtherCAT terminals can cause serious damage or electrical shock. @@ -45,35 +66,170 @@ Working on live EtherCAT terminals can cause serious damage or electrical shock. --- ### 3.2.2 Wiring Steps (Used in This Example) + +We supply power to the other devices by using the **750-602 EtherCAT Power Terminal** + +Perform the following wireing on the Ethernet-Switch: + +1. Red wire (+24V) → PWR+ +2. Black wire (0V) → RPS- -#### **Figure 1 — WAGO Minimal Wiring** +#### **Figure 1 —** + -### 3.3 WAGO Integration +--- -#### **Figure 2 — WAGO Terminal** +### 3.3 WAGO Wireing the Coupler -### 3.4 Final Assembled Setup +Wire the **750-354 EtherCAT Coupler** for the power supply +1. red wire (+24V) +2. yellow (0V) -#### **Figure 3 — Connected** +#### **Figure 2 —** + -## 3.5 Power & Ethernet +--- -### 3.5.1 Power +### 3.4 750-602 EtherCAT Power Terminal Integration -#### Example AC/DC Adapter (Figure 4): +Slide the **750-602 EtherCAT Power Terminal** onto the **right side of the 750-354 Coupler** until it locks. -### 3.5.2 Ethernet +Next We need to Wire the EtherCat E-Bus + +Perform the next wireing Steps: + +1. Green wire (Ground) → **Terminal4** +2. Red wire (+24V) from **750-602 EtherCAT Power Terminal** → **Terminal 2** +3. Black wire(0V) from **750-602 EtherCAT Power Terminal** → **Terminal 3** +4. Red wire (+24V) from **750-354 EtherCAT Coupler** → **Terminal 6** +5. Yellow wire (0V) from **750-354 EtherCAT Coupler** → **Terminal 7** + +#### **Figure 3 — Wireing** + + +--- + +## 3.5 750-402 EtherCAT Terminal Integration + +Slide the **750-402 EtherCAT Terminal** onto to **right side of the 750-602 EtherCAT Power Terminal** until it locks. + +Wire from the **24V DC Lab Adapter** → **Terminal 1** + +#### **Figure 4 — Wireing** + + +## 3.6 750-600 Final Assemly + +Slide the **750-600 EtherCAT Endmodule** onto to **right side of the 7750-402 EtherCAT Terminal** until it locks. + +No wireing is require + +#### **Figure 5 — 750-402 + 750-600 Connected** + + +## 3.7 Power & Etherneet + +### Power + +Connect the 2787-2144 EtherCAT to the power outlet + +### Ehternet + +Use a standard LAN cable to your PC → **852-1322 Ethernet-Switch** + +And another from **852-1322 Ethernet-Switch** → **750-354 EtherCAT Coupler** + +#### **Figure 6 — Ethernet** + ## 4. Software Setup ### 4.1 Installing on Ubuntu/Debian +Paste this into your terminal: +```bash +# Press Enter when prompted +curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + +sudo apt update +sudo apt install -y npm nodejs git + +git clone git@github.com:qitechgmbh/control.git +cd control/electron +npm install +``` ### 4.2 Running the Backend +```bash +./cargo_run_linux.sh +``` +This script: + +- Builds the backend + +- Grants required system capabilities (raw sockets) + +- Starts EtherCAT communication + +Ensure the WAGO750-402 is connected. ### 4.3 Running the Frontend +```bash +cd electron +npm run start +``` + +This launches the QiTech Control dashboard. ## 5. Demo ### 5.1 Assigning Devices in the Dashboard -## 6. References \ No newline at end of file +Once the backend + frontend are running, you should see: + +- WAGO750-354 (Coupler) + +- wago module (Digital Input Terminal) +![](../assets/WAGO750_402_discovery.png) + +Steps: + +- Click Assign on the wago module + +- Select Digital Input Machine V1 + +![](../assets/WAGO750_402_setmachine.png) + + +- Enter a serial number exept for 0 + +![](../assets/WAGO750_402_serserial.png) + +- Click Write + +### 5.2 Diyplaying LED +Navigate to: + +Machines → DigitalInputMachine +![](../assets/WAGO750_402_machinedetected.png) +You will see this interface: + +![](../assets/WAGO750_402_machinecontrol1.png) + +you can now flow a DC of the Range of 15V-30V (+24V recommended) + +it schould light up the First LED +![](../assets/WAGO750_402_machinecontrol2.png) + +## 6. References +This guide incorporates information from official WAGO documentation. +All diagrams, product names, and figures belong to Beckhoff Automation GmbH & Co. KG and are used here solely for educational purposes. + +Referenced Manuals + +[WAGO 750-402 Documentation](https://www.wago.com/de/io-systeme/4-kanal-digitaleingang/p/750-402#downloads) + +[WAGO 750-354 Documentation](https://www.wago.com/de/io-systeme/feldbuskoppler-ethercat/p/750-354#details) + +[WAGO 750-602 Documentation](https://www.wago.com/de/io-systeme/potentialeinspeisung/p/750-602#details) + +[WAGO 750-354 Documentation](https://www.wago.com/de/io-systeme/endmodul/p/750-600#details) \ No newline at end of file