From 5883e467eb5bce75aeccd4ea9666224db2e20d18 Mon Sep 17 00:00:00 2001 From: Raoul Hecky Date: Sun, 31 Mar 2024 17:40:03 +0000 Subject: [PATCH] translation --- content/hardware/requirements.en.md | 63 +++++++++++ content/hardware/requirements.fr.md | 6 +- content/hardware/wago/_index.en.md | 53 +++++++++ content/hardware/wago/codesys.en.md | 111 +++++++++++++++++++ content/hardware/wago/dali.en.md | 157 +++++++++++++++++++++++++++ content/hardware/wago/dali.fr.md | 4 +- content/hardware/wago/failsafe.en.md | 95 ++++++++++++++++ content/hardware/wago/input.en.md | 27 +++++ content/hardware/wago/output.en.md | 35 ++++++ 9 files changed, 546 insertions(+), 5 deletions(-) diff --git a/content/hardware/requirements.en.md b/content/hardware/requirements.en.md index 69a1550..9f18ffb 100644 --- a/content/hardware/requirements.en.md +++ b/content/hardware/requirements.en.md @@ -5,3 +5,66 @@ weight = 5 summary = 'Requirements' +++ +## Installation + +Welcome to the technical section dedicated to Calaos home automation. Here, DIY installers will find everything they need to know to complete a Calaos installation. This section includes an overview diagram of all the components in a Calaos home automation system, along with a list of the most important elements. + +Through various links, you'll have access to each product's specifications, wiring explanations, and every programming step. Make sure to carefully read each point to not miss any installation steps. + +Good luck! + +## Foundation + +![schema](/en/hardware/images/schema.png?width=40pc) + +### Prerequisites + +For a home automation installation in a new house or as part of significant renovations, we strongly recommend starting with a Wago PLC-based Calaos approach for its durability and cost-effectiveness. Here are some key tips to get started on the right foot: + +- **Specific Wiring Topology**: The wiring architecture for Calaos with a Wago PLC is different from traditional electrical installations. It's essential to plan for a suitable topology that will facilitate the integration of home automation and make it more efficient. + +- **Material Compatibility**: Not all electrical components are suitable for use with Calaos. Choosing compatible materials is crucial to ensure your home automation system works correctly. + +While Calaos is compatible with popular technologies like Zigbee, opting for dedicated wiring and equipment from the start is the best approach for a reliable and long-lasting installation. This method minimizes the risk of malfunctions and ensures the longevity of your home automation system. + +Opting for Calaos from the outset of your home design or at the beginning of a major renovation will allow you to benefit from a stable, durable, and cost-effective system in the long term. + +#### Control Circuit Wiring + +The control circuit is separate and comes directly from the communication panel or a junction box. The wiring is then done by branching loop (four or five switches in a row, depending on the type of cable) with a four-pair telephone type cable (section 0.6 mm²) or more. + +{{% notice info %}} +All controls are simple push buttons +{{% /notice %}} + +For example, here is a wiring diagram for push buttons. A 4-pair cable can wire up to 7 push buttons since one wire is needed for the +24v common. However, it's sometimes better to reserve some wires for adding switches later. + +![schema](/en/hardware/images/bp.png?width=20pc) + +#### Power Circuit Wiring + +The power circuit comes directly from the distribution panel or a junction box. Each circuit is separated to be controlled individually. The cable used should be of traditional section (3×1.5mm² for lights and 4×1.5mm² for roller shutters). + +{{% notice info %}} +For compatibility with the Calaos system, all roller shutters must be wired and controlled at 230v with simple up/down actions. +{{% /notice %}} + +For example, here is a wiring diagram for lights. + +![schema](/en/hardware/images/lum.jpg?width=20pc) + +And another example with a wiring diagram for shutters. + +![schema](/en/hardware/images/vol.jpg?width=20pc) + +### Electrical Panel + +When setting up a home automation system with Calaos, especially using Wago PLCs and relays, it's important to consider the necessary space for the installation. Due to their size and functionality, these components can take up significant space in your electrical panel. + +We recommend planning for a sufficiently large distribution panel to accommodate both the traditional electrical part of your home and the additional components related to home automation. The quality and dimensions of the electrical panel are crucial for an organized and secure installation. + +It's advisable to choose an electrical panel that offers ample space for the entire system, considering not only the current dimensions of your installation but also the possibility of future expansions. Ensure that the chosen panel can accommodate the Wago PLCs and relays while leaving enough room for easy maintenance and the addition of new components if necessary. + +Here's an example of a panel, with the traditional breaker part on the left and the low-voltage part with relays, the PLC, and even the network on the right: + +![schema](/en/hardware/images/tableau.jpg?width=60pc) diff --git a/content/hardware/requirements.fr.md b/content/hardware/requirements.fr.md index 19dbb2f..6d127a3 100644 --- a/content/hardware/requirements.fr.md +++ b/content/hardware/requirements.fr.md @@ -21,9 +21,9 @@ Bon courage! Pour une installation domotique dans une maison neuve ou dans le cadre de rénovations importantes, nous recommandons fortement l'approche Calaos avec une base d'automate Wago pour sa durabilité et son efficacité économique. Voici quelques conseils clés pour démarrer sur de bonnes bases : -- Topologie de câblage spécifique : L'architecture de câblage pour Calaos avec un automate Wago diffère des installations électriques classiques. Il est essentiel de prévoir une topologie adaptée qui facilitera l'intégration de la domotique et la rendra plus efficace. +- **Topologie de câblage spécifique** : L'architecture de câblage pour Calaos avec un automate Wago diffère des installations électriques classiques. Il est essentiel de prévoir une topologie adaptée qui facilitera l'intégration de la domotique et la rendra plus efficace. -- Compatibilité des matériaux : Tous les composants électriques ne se valent pas pour une utilisation avec Calaos. Il est crucial de sélectionner des matériaux compatibles pour garantir le bon fonctionnement de votre système domotique. +- **Compatibilité des matériaux** : Tous les composants électriques ne se valent pas pour une utilisation avec Calaos. Il est crucial de sélectionner des matériaux compatibles pour garantir le bon fonctionnement de votre système domotique. Bien que Calaos soit compatible avec des technologies populaires comme Zigbee, pour une installation pérenne et fiable, privilégier un câblage et des équipements dédiés dès le départ est la meilleure approche. Cette méthode minimise les risques de dysfonctionnement et assure une meilleure longévité de votre système domotique. @@ -31,7 +31,7 @@ Adopter Calaos dès la conception de votre maison ou au début d'une grande rén #### Câblage du circuit de commande -Le circuit de commande est séparé et provient directement du tableau de communication ou d'une boîte de dérivation. Le câblage est alors effectué par bouclage arborescent (quatre ou cinq interrupteurs à la suite selon le type de câble) avec du câble de type téléphone quatre paires (section 0,6 mm²) ou plus. +Le circuit de commande est séparé et provient directement du tableau de communication ou d'une boîte de dérivation. Le câblage est alors effectué par bouclage arborescent (quatre ou cinq interrupteurs à la suite selon le type de câble) avec du câble de type téléphone quatre paires (section 0,6 mm²) ou plus. {{% notice info %}} Toutes les commandes sont des boutons poussoirs simples diff --git a/content/hardware/wago/_index.en.md b/content/hardware/wago/_index.en.md index a7c8f06..24a5730 100644 --- a/content/hardware/wago/_index.en.md +++ b/content/hardware/wago/_index.en.md @@ -4,3 +4,56 @@ date = 2024-03-06T20:02:33Z weight = 10 summary = 'Wago PLC of the type 750-841, 750-880, ...' +++ + +## Wago PLC + +![module](/en/hardware/wago/images/20080819-IMG_9203.jpg?width=40pc&classes=shadow) + +The Wago PLC forms the foundation of a Calaos installation. Equipped with industrial components to ensure quality and durability, this PLC is responsible for controlling all the electrical elements in the house, as well as acquiring the state of switches, temperature probes, sensors, and much more. It thus plays a crucial role in bridging the computer world of the central unit and the electrical world. + +### Safety + +The PLC also incorporates a backup program in case the main computer system fails. In the event of a communication breakdown with Calaos, it switches to autonomous mode. This ensures increased system reliability, allowing users to interact with their home as with a traditional electrical installation, thereby mitigating concerns related to computer failures. + +### Range of PLCs + +The advantage of the Wago PLC lies in its modularity. It is therefore scalable and adaptable to all types of installations. For example, it is always possible to add a module later to control an additional room. The main module incorporates the system's intelligence and a network communication port to interact with the computer system and receive commands from the Calaos server. Depending on the version, this module may also include an additional Ethernet port for the KNX or DMX protocol. The PLC allows connecting to its internal bus analog and digital input/output terminals, as well as terminals specific to other communication buses (DALI, KNX, etc.). + +We mainly use these PLC heads: + +- The 750-841 head (Replaced by 750-881, 750-880, 750-891, 750-893) +- The 750-849 head for installations requiring KNX compatibility. (Replaced by 750-889) + +For more information on a Calaos installation compatible with KNX, you can visit this page: [KNX Installation]({{%relref "hardware/wago/knx" %}}) + +## Electrical Safety + +From a safety standpoint, the Wago PLC complies with the IP20 protection standard by incorporating galvanic isolation between the internal electronics and the field. This protection against short circuits is ensured by optocouplers, among other components. + +## Modules and Extensions + +To collect information from switches, we use digital input terminals. These terminals operate with low currents of 24V DC and function on the principle of [on/off](https://en.wikipedia.org/wiki/Bang%E2%80%93bang_control). The output modules, on the other hand, allow controlling elements such as lighting or motorized blinds. + +Here is a list of different modules and extensions that can be added to a Wago PLC. + +### Switches, binary sensors + +- [4,8,16 channel 24V input module]({{%relref "hardware/wago/input" %}}) + +### Lighting points, blinds, shutters, on/off outputs + +- [4,8,16 channel 24V output module]({{%relref "hardware/wago/output" %}}) + +### Light dimming + +- [DALI interface module]({{%relref "hardware/wago/dali" %}}) +- [DMX module]({{%relref "hardware/wago/dmx" %}}) + +### Heating, various, ... + +- [PT100/PT1000 temperature probe input module]({{%relref "hardware/wago/pt1000" %}}) +- [Analog input/output module]({{%relref "hardware/wago/analog" %}}) + +### Bus extender + +- [Extending a Wago bus]({{%relref "hardware/wago/750-627" %}}) diff --git a/content/hardware/wago/codesys.en.md b/content/hardware/wago/codesys.en.md index e2e5d7f..4e8d0d7 100644 --- a/content/hardware/wago/codesys.en.md +++ b/content/hardware/wago/codesys.en.md @@ -3,3 +3,114 @@ title = 'Codesys' date = 2024-03-06T20:02:41Z weight = 10 +++ + +## Programming Calaos on Wago PLCs + +To operate a Wago PLC with Calaos, it must first be loaded with the Calaos program. There are two ways to program a PLC with Calaos: + +- using Calaos Installer +- using Codesys + +## IP Address + +In any case, it's necessary to configure the PLC's IP address beforehand. It's advisable to refer to Wago's documentation for setting up a static IP address. By default, a PLC is set to DHCP. To switch to a static IP address, the Wago Ethernet Settings software should be used. This software also allows for searching the PLC on the network. + +For PLCs equipped with DIP Switches on the front for IP setting, follow these steps: + +- Set the PLC's selector to the middle position. +- Choose the IP address via the selectors. The address will be in the form of 192.168.1.XXX. +- Set the PLC's selector to the upper position. + +To verify if the PLC is correctly configured on the network, simply access the PLC's web page via http://192.168.1.XXX. The web page should open. + +## Calaos-Wago Program + +First, download the Calaos code from [Github](https://github.com/calaos/calaos_wago/archive/master.zip). The archive contains all the code for all supported PLCs and the used libraries. Just extract the zip somewhere. + +### Versions of calaos_wago + +|Version|Notes| +|-|-| +|1.7 - 2.2| Old version, do not use| +|2.3| Stable version. Only works if no DALI Master 750-647 terminal is present| +|3.0| Stable version for use only with a DALI Master 750-647 terminal| + +## Programming with Calaos Installer + +The simplest solution is to use Calaos Installer. Just open the **Flash PLC with custom firmware** tool in the Wago menu. Then enter the IP of the PLC you wish to install. Calaos Installer will then ask you to select 2 files (use CTRL+select), a `.PRG` file and a `.CHK` file. Make sure to choose the correct version corresponding to your PLC and the desired version. + +![img](/en/hardware/wago/images/wago_flash.png?width=20pc&classes=shadow) + +{{% notice note %}} +Programming the PLC can take several minutes, be patient even if you don't see any progress. +{{% /notice %}} + +## Programming with Codesys + +Codesys is the PLC development tool. This tutorial uses version 2.3.9.xx. It's recommended to use the full version of Codesys, as the demo version does not allow the code to remain in the PLC after a restart. + +{{% notice note %}} +It's advised to use Codesys in English, as the French version has some translations that are hard to understand. To change the language, go to Project Menu, Options, Working Environment, and choose English. +{{% /notice %}} + +### Opening the project in Codesys + +Start by running Codesys and then open the project corresponding to your PLC (e.g., wago_881.pro for a 750-881). Choose the latest version that can be found in the folder. E.g., Wago_3.0 for version 3.0 of the program. + +Once the project is open, there should be no errors. An information message might pop up indicating that libraries have been modified, just validate it. + +![img](/en/hardware/wago/images/codesys01.jpg?width=20pc&classes=shadow) + +### Compiling the Project + +To recompile the project, go to the **Project** menu then **Rebuild All**. + +![img](/en/hardware/wago/images/codesys02.jpg?width=20pc&classes=shadow) + +If everything goes well, the console at the bottom should show **0 Errors**. + +![img](/en/hardware/wago/images/codesys03.jpg?width=20pc&classes=shadow) + +### Selecting the PLC's IP + +Next, go to **Online**, **Communication parameters**. + +![img](/en/hardware/wago/images/codesys04.jpg?width=20pc&classes=shadow) + +The following window will open: + +![img](/en/hardware/wago/images/codesys05.jpg?width=20pc&classes=shadow) + +Change the IP address in this window by double-clicking on it, then click OK. + +### Loading + +To load the PLC, go to **Online**, **Login**. The project will be compiled automatically if necessary, and the connection with the PLC will be established. If the connection works, Codesys will ask if you want to load the new program. Of course, respond **Yes**. + +Loading can take some time (several minutes). Once finished, Codesys will switch to debuggermode, but the program is not executed. You can see whether the program is running at the bottom right. + +![img](/en/hardware/wago/images/codesys07.jpg?width=20pc&classes=shadow) + +Before executing the program, it must be written to non-volatile memory. Otherwise, everything will disappear after the next PLC reboot. To do this, once in **Online** mode, go to the **Online** menu, **Create boot project**. + +![img](/en/hardware/wago/images/codesys08.jpg?width=20pc&classes=shadow) + +This process will take some time, let Codesys complete its task. + +## Calaos Installer + +For Calaos Installer to work with the PLC, the PLC's LED must be steady orange. Do not connect to the PLC with Calaos Installer at the same time as `calaos_server`. It's essential to disconnect `calaos_server` from the network in this case. + +In Calaos Installer: + +- Go to the PLC menu → **Connect**, and enter the PLC's IP. +- Once connected, the bottom right of the window should display `connected (2.2)` with the PLC's version. +- If it's ok, the degraded mode configuration can be sent with PLC Menu → **Program the PLC**. +- The rules will work immediately without needing to restart the PLC. + +For switch detection: + +- You need to be connected to the PLC in Calaos Installer! +- If detection doesn't work, check that the LED on the input terminal lights up. +- If it still doesn't work, it might be a problem with Windows firewalls not letting UDP frames through correctly... Try disabling the firewall. +- If it still doesn't work, it's not a big deal; rules can still be created by specifying the input number to use for the switch. Count the input number directly on the terminal. diff --git a/content/hardware/wago/dali.en.md b/content/hardware/wago/dali.en.md index 0882eae..0106162 100644 --- a/content/hardware/wago/dali.en.md +++ b/content/hardware/wago/dali.en.md @@ -3,3 +3,160 @@ title = 'DALI Dimming' date = 2024-03-06T20:03:09Z weight = 50 +++ + +## DALI Interface Module + +One of the main advantages of home automation is lighting management. To properly implement it, the ability to adjust the intensity of light points is essential. A light dimming technology uses the [DALI (Digital Addressable Lighting Interface)](https://en.wikipedia.org/wiki/Digital_Addressable_Lighting_Interface) standard. + +![module](/en/hardware/wago/images/borne_dali.jpg?width=20pc&classes=shadow) + +The coalition of suppliers around a standard has allowed for interoperability in controlling electronic ballasts. This new standard is gradually replacing the old 0-10V dimming interface. The Wago 750-641 is a DALI master module, capable of controlling up to 64 slave ballasts. The ballasts come in different types such as: + +- Transformers for spotlights +- Transformers for LED lighting +- RGB tricolor transformers for LED lighting +- Electronic ballasts for compact fluorescent tubes + +Two DALI terminals are available: the older generation DALI terminal, **750-641**, and the DALI Master terminal, **750-647**. It's important to note that these terminals offer different functionalities in terms of configuration in Calaos. + +The older generation DALI terminal, model **750-641**, is designed to operate only as a DALI slave. It's suitable for traditional applications where simple integration with other masters is not necessary. + +On the other hand, the DALI Master terminal, model **750-647**, offers advanced functionalities as a DALI master. It supports not only the control of multiple DALI devices as a master but also operates as a multi-master master, allowing support for DALI motion or brightness sensors (such as the Tridonic M-Sensor2, for example). + +## Installation of the Terminal in the PLC + +The DALI terminal must be installed directly after the digital I/O modules. It's imperative to install any other analog terminal **after the DALI terminal**. The calaos_wago program supports only one DALI terminal. Therefore, it's not possible to have multiple DALI terminals (master or not). + +## Wiring + +![module](/en/hardware/wago/images/wago-288-895.jpg?width=5pc&classes=shadow) + +The wiring of DALI elements differs entirely from traditional lighting points. This time a 2-wire communication bus needs to be set up. Moreover, this bus requires a specific dedicated 18V power supply. + +As mentioned above, DALI is an interface for controlling lighting electronic ballasts and transformers. Thus, the desired lighting fixtures must be equipped with DALI-compatible transformers. + +![module](/en/hardware/wago/images/schema_dali.png?width=20pc&classes=shadow) + +Each ballast can be connected to the bus. The DALI bus does not require a specific polarity for connection, but care must be taken not to create loops or short circuits. A maximum of 64 slaves can be connected to the terminal. Note that some RGB transformers use 3 addresses (one for each color). + +It's recommended to use a minimum of 1.5mm² cable for the 2-wire DALI bus. A smaller section could cause signal interference. + +## Programming + +### Addresses + +Once the ballasts are connected to the bus, they need to be identified. + +#### 750-641 + +You will need to use the [Calaos Installer]({{%relref "calaos_installer/wago" %}}) software and perform an address search. The principle of the DALI bus is simple: each element is assigned an address ranging from 1 to 64. The control unit and the PLC need to know the address at which the equipment can be controlled. + +- Disconnect the Calaos server +- Open Calaos Installer, connect to the PLC, and use the **DALI Configuration...** tool + +![module](/en/hardware/wago/images/calaos_installer_dali.png?width=20pc&classes=shadow) + +It is possible to do the addressing and configure the DALI groups directly in the interface. + +#### 750-647 + +The addressing of DALI equipment should be done with the **Wago Dali Configurator** software. This software only works with the 753-647 terminal. On the DALI bus with the master terminal, 64 ballast addresses are supported. In addition, there are 14 addresses for detectors. However, a detector like the Tridonic M-Sensor2 requires 3 addresses. Be careful not to exceed these limits (which are related to the DALI bus). + +##### Wago Dali Configurator + +- Disconnect the Calaos server +- Set the Wago to STOP mode via the switch (central position) +- Launch Wago Dali Configurator +- Start a search for unaddressed devices +- To find the color corresponding to the address, you can light up the selection +- Configure the ballasts and write the configuration (In the example, there is an RGBW ballast (⇒ 4 addresses)) + +{{% notice note %}} +It is recommended to change the ballasts' address to a number higher than 3. Indeed, if a ballast is added later, it might conflict with the existing ballasts. +{{% /notice %}} + +![module](/en/hardware/wago/images/daliconfiguratorparametres.jpg?width=20pc&classes=shadow) + +{{% notice note %}} +The terminal position doesn't correlate with the card's position on the bus but rather with the number of DALI cards (1). +{{% /notice %}} + +![module](/en/hardware/wago/images/daliconfiguratoradressage.jpg?width=20pc&classes=shadow) + +![module](/en/hardware/wago/images/daliconfiguratorpoweron.jpg?width=20pc&classes=shadow) + +![module](/en/hardware/wago/images/daliconfiguratorwriteparam.jpg?width=20pc&classes=shadow) + +##### Configuration in Calaos Installer + +Once in Calaos Installer, simply adding Wago Dali devices isn't enough for it to work with the 750-647 terminal. It's also necessary to declare all devices on the bus and send this configuration to the PLC. + +To do this, you need to connect to the PLC with Calaos Installer. Then go to the **Wago PLC** → **Upload Dali Master 647 Configuration** page. + +![pic](/en/hardware/wago/images/calaos_installer_dali_master.jpg?width=20pc&classes=shadow) + +In this tool dedicated to the Dali Master terminal, list all Dali devices on the bus along with their respective addresses. The **Load from PLC** button allows reloading a configuration stored in the PLC. The **Send to PLC** button does the opposite, sending the configuration to the PLC. The PLC will automatically restart. + +After this configuration is complete, Calaos Installer can be used in the traditional manner by adding Dali Light objects. + +##### Addresses + +##### Ballasts + +The addresses for DALI ballasts start at 1 in Calaos. This is not the case in the Wago Dali Configurator, so care should be taken. + +##### Sensors + +To use presence detectors or Dali switches, you must use classic Wago Switches in Calaos Installer. Their addresses start at **6656**. + +Ex: + +| DALI Address | Wago Dali Configurator Address | Calaos installer Switch Address | +|----------|------|------| +| 1 | 0 | 6656 | +| 2 | 1 | 6657 | +| 3 | 2 | 6658 | +| 4 | 3 | 6659 | +| ... | ... | ... | + +When setting up detectors in Calaos Installer, you can specify an _Off Timeout_. This refers to the duration it takes for the detector to switch back to the low state after activation. + +##### Luxmeter + +It's possible to retrieve the value of luxmeters in Calaos. To do this, create a Wago Input Analog IO in Calaos Installer and assign it the DALI address + 255. + +Ex: + +| DALI Address | Wago Dali Configurator Address | Calaos installer Sensor Address | +|----------|------|------| +| 1 | 0 | 256 | +| 2 | 1 | 257 | +| 3 | 2 | 258 | +| 4 | 3 | 259 | +| ... | ... | ... | + +#### Example with 750-647 + +For the following detector: + +{{% notice note %}} +Multi Sensor Type 2: Presence address: 1 Light address: 2 IR address: 3 Offtimeout: 10000ms +{{% /notice %}} + +In Calaos Installer, the following IOs can be declared: + +- Wago Switch address: 6656 +- Wago Switch address: 6658 +- Wago Analog Input address: 257 + +For the detector, the following rule can be created: + + IF SensorPresence == True + IF SensorLux <= 50 + Then LightDali = impulse 600000 + +If the presence detector is triggered and the luxmeter reads below 50 Lux, then turn on the DALI light for 10 minutes. + +### Programming + +Programming is also carried out using the Calaos Installer software. Unlike classic lighting elements, you can play with the intensity of the lights. diff --git a/content/hardware/wago/dali.fr.md b/content/hardware/wago/dali.fr.md index 9e2cdaa..4a998a4 100644 --- a/content/hardware/wago/dali.fr.md +++ b/content/hardware/wago/dali.fr.md @@ -111,7 +111,7 @@ Pour utiliser des detecteurs de presence ou des interrupteurs Dali, il faut util Ex: -| Adresse DALI | Adresse Wago Dali Configurator | Adresse Calaos installer inter | +| Adresse DALI | Adresse Wago Dali Configurator | Adresse Calaos installer entrée | |----------|------|------| | 1 | 0 | 6656 | | 2 | 1 | 6657 | @@ -127,7 +127,7 @@ Il est possible de recuperer la valeur des luxmetres dans calaos. Pour cela, il Ex: -| Adresse DALI | Adresse Wago Dali Configurator | Adresse Calaos installer inter | +| Adresse DALI | Adresse Wago Dali Configurator | Adresse Calaos installer détecteur | |----------|------|------| | 1 | 0 | 256 | | 2 | 1 | 257 | diff --git a/content/hardware/wago/failsafe.en.md b/content/hardware/wago/failsafe.en.md index ac2da20..0a49470 100644 --- a/content/hardware/wago/failsafe.en.md +++ b/content/hardware/wago/failsafe.en.md @@ -3,3 +3,98 @@ title = 'Failsafe mode' date = 2024-03-06T20:03:53Z weight = 20 +++ + +## Wago PLC Fallback Mode + +The fallback mode in Calaos is an alternative operational state activated when the Calaos server can no longer communicate with the PLC, such as during a network failure. The PLC switches to fallback mode after a certain period (30 seconds) and continues to control certain elements like lighting points and shutters using switches, although not all server mode rules can be managed. The fallback mode can only execute a few simple rules automatically generated by the Calaos Installer software during the PLC's configuration. Inputs can be associated with specific actions such as toggle, direct, shutter, etc., with parameters defined for each action. + +## LED + +The USR LED on a Wago PLC with Calaos indicates the operational state: + +- **Green** : Everything is functioning normally. The PLC is communicating with the Calaos server, and all configured functions are active. +- **Orange** : The PLC is in fallback mode, often due to a loss of communication with the server. In this mode, there are limitations: some basic functions can still be manually controlled, like lighting or shutters, but without the full range of commands and usual rules. + +## Supported Rules in Fallback Mode + +Here's a list of rules supported in fallback mode: + +|Type|Notes| +|-|-| +|Toggle|Acts like a toggle switch, flipping the output to 0 or 1 with each press| +|Direct|Sets the output to 1 as long as the input is 1 and to 0 as soon as released| +|Shutter|Controls a classic shutter with 2 output channels for up/down| +|Pulse Shutter|Controls a shutter with a pulse instead of maintaining the relays| +|DALI Toggle|Controls a DALI light in ON/OFF| +|DALI Group Toggle|Controls a DALI group in ON/OFF| +|KNX Toggle|Controls a KNX output (only for KNX/Wago installations)| +|Direct KNX|Same as Direct but in KNX| + +## Programming Fallback Mode + +The simplest way to program the fallback configuration in the PLC is to use Calaos Installer and the **Send Fallback Program** tool in the **Wago** menu. You must be connected to the PLC beforehand. + +{{% notice note %}} +Calaos Installer will automatically send and convert the configured rules. Keep in mind that complex rules are not converted and will therefore not be used in fallback mode. This may leave some switches non-functional in fallback mode. A trick is to use a 2nd configuration exclusively for fallback mode in Calaos Installer. This configuration should not be sent to Calaos Server, but only to the PLC. +{{% /notice %}} + +## Programming Fallback Mode via Console + +You can use the `wago_test` tool to program the fallback mode. This tool is capable of sending and receiving a complete config or configuring a single input. + +To retrieve the config: + + wago_test host 192.168.0.xxx action save_config failsafe_config.txt + +To send the config: + + wago_test host 192.168.0.xxx action load_config failsafe_config.txt + +The file contains a configuration in this form: + + WAGO_SET_OUTTYPE 0 0 + WAGO_SET_OUTADDR 0 0 0 -1 + WAGO_SET_OUTTYPE 1 1 + WAGO_SET_OUTADDR 1 25 0 -1 + WAGO_SET_OUTTYPE 2 3 + WAGO_SET_OUTADDR 2 30 31 -1 + WAGO_SET_OUTTYPE 3 1 + WAGO_SET_OUTADDR 3 0 0 1 + +To change the config of an input: + + wago_test host 192.168.0.xxx action set_outtype 2 VOLET + wago_test host 192.168.0.xxx action set_outaddr 2 1 2 -1 + +In fallback mode, each input is associated with an action of a following type: + +|Type|Notes| +|-|-| +|NONE|Default action, does nothing| +|TELERUPTEUR|Acts like a toggle switch, flipping the output to 0 or 1 with each press| +|DIRECT|Sets the output to 1 as long as the input is 1 and to 0 as soon as released| +|VOLET|Controls a classic shutter with 2 output channels for up/down| +|VOLET IMPULSE|Controls a shutter with a pulse instead of maintaining the relays| +|TELERUPTEUR DALI|Controls a DALI light in ON/OFF| +|TELERUPTEUR DALI GROUP|Controls a DALI group in ON/OFF| +|TELERUPTEUR KNX|Controls a KNX output (only for KNX/Wago installations)| +|DIRECT KNX|Same as Direct but in KNX| + +Then each input is associated with 3 parameters: + +- **out1**: output address. For example, the lamp's address for the TOGGLE type, the shutter's up address for the SHUTTER type, the DALI address for the DALI type, etc. +- **out2**: 2e adresse de sortie si besoin (utilisé que dans le cas des volets pour la descente) +- **SameAs**: A second output address if needed (used only in the case of shutters for lowering). + + On peut avoir cette série de règles : + + Input 0 -> NONE + Input 0 -> out1=0 out2=0 SameAs=-1 + Input 1 -> TELERUPTEUR + Input 1 -> out1=25 out2=0 SameAs=-1 + Input 2 -> VOLET + Input 2 -> out1=30 out2=31 SameAs=-1 + Input 3 -> TELERUPTEUR + Input 3 -> out1=0 out2=0 SameAs=1 + +Here, Input 0 is configured to do nothing. Input 1 controls a light connected to output 25. Input 2 operates a shutter, with raising linked to address 30 and lowering to address 31. Input 3 is unique. It's set up as a toggle switch (similar to Input 1) but with addresses set to 0 and the "SameAs" parameter set to 1. This means Input 3 will control the same light as Input 1, using the same function block and maintaining the light's state. This allows multiple switches to control the same light/shutter. Remember, "SameAs" should be set to -1 if it's not in use. diff --git a/content/hardware/wago/input.en.md b/content/hardware/wago/input.en.md index 29ec4c8..2376152 100644 --- a/content/hardware/wago/input.en.md +++ b/content/hardware/wago/input.en.md @@ -3,3 +3,30 @@ title = 'Input module' date = 2024-03-06T20:02:53Z weight = 30 +++ + +## 4, 8, 16 Channel Input Modules + +Paired with the fieldbus controller, the 4, 8, 16 channel 24V DC digital input modules allow for the connection of push buttons as well as any on/off signal inputs. + +## Wago Modules + +The terminal block allows for the connection of 4, 8, or 16 dry contacts and is galvanically isolated. + +- 750-402: 4 inputs 24V +- 750-430: 8 inpuots 24V +- 750-1405: 16 inputs 24V + +![module](/en/hardware/wago/images/borne_entree8.jpg?width=10pc&classes=shadow) +![module](/en/hardware/wago/images/borne_entree16.jpg?width=10pc&classes=shadow) + +## Wiring + +The wiring of switches is done with 24V low voltage by injecting +24V into the input terminal. This can be done as shown in the figure below, using the PLC's 24V power supply. + +![module](/en/hardware/wago/images/schema_inter.png?width=20pc&classes=shadow) + +## Programming + +Configuring a switch is done using the [Calaos Installer]({{%relref "calaos_installer/wago" %}}) software. You may need to know the input number of the switch on the PLC. For example, in the diagram above, switch 1 is connected to input 0 of the PLC, and switch 2 to input 1 of the PLC. + +It's important to note that the numbering of input terminals starts from 0 for the first terminal and then continues with the following input terminals. Thus, the first terminal is numbered 0, the next one 8 (for 8-channel terminals), and so on. diff --git a/content/hardware/wago/output.en.md b/content/hardware/wago/output.en.md index 177e7c6..1b5c1f1 100644 --- a/content/hardware/wago/output.en.md +++ b/content/hardware/wago/output.en.md @@ -3,3 +3,38 @@ title = 'Output module' date = 2024-03-06T20:02:58Z weight = 40 +++ + +## 4, 8, 16 Channel Output Modules + +To control electrical elements such as lighting fixtures, electric blinds/shutters, controlled sockets, etc., we use a 24V DC digital output module. This on/off output terminal allows connecting up to 8 actuators. Typically, these actuators are 24V/220V 16A power relays, capable of supporting the load of lighting fixtures and controlled sockets in a house. + +The terminal allows connecting 8 dry contacts and is galvanically isolated. + +![module](/en/hardware/wago/images/borne_sortie8.jpg?width=10pc&classes=shadow) +![module](/en/hardware/wago/images/borne_sortie16.jpg?width=10pc&classes=shadow) + +## Wiring + +The wiring of outputs to relays is done at low voltage as shown in the diagram below. + +![module](/en/hardware/wago/images/schema_relais.png?width=20pc&classes=shadow) + +### Lighting Points, Controlled Socket + +The diagram shows the connection of 2 lighting points. The principle is exactly the same for a controlled socket. Since the power relays have a breaking capacity of 16A, they are sufficient for use in these cases. + +### Shutter + +The case of the shutter is also the same. Indeed, a shutter **must be wired with up and down controls**. It then connects like 2 lighting points, using 2 relay outputs. The programming will then use one of the outputs for up and the other for down. + +Two operating modes of shutters are compatible. The classic mode, where the relays must be held to perform an up/down action, and the pulse control mode, where a pulse is sufficient to give the order to the shutter. The programming will allow choosing the appropriate mode and the central unit will do the necessary work. + +### Heating + +The case of heating is similar in certain cases where a heating zone can be controlled with an on/off output. Usually, a heating zone can easily be controlled by connecting a solenoid valve to the desired circuit, then connecting this solenoid valve to a relay output. + +## Programming + +Configuring an output is done using the [Calaos Installer]({{%relref "calaos_installer/wago" %}}) software. You will need to know the output number of the PLC. For example, in the diagram above, lamp 1 is connected to output 0 of the PLC and lamp 2 to output 1 of the PLC. Therefore, it is necessary to assign an identifier to know the number of each light, shutter, etc. + +It is important to note that the numbering of the output terminals starts from 0 for the first terminal and then continues with the following output terminals. Thus, the first terminal is numbered 0, the next one 8, and so on.