Gira S1 Configuration
  1. Manuals
  2. Brands
  3. Gira Manuals
  4. Home Automation
  5. S1
  6. Configuration

Gira S1 Configuration

Hide thumbs
Table of Contents

Advertisement

Quick Links

KNX
Product documentation
Status of the documentation:
10.08.2020
Gira S1
Order No. 2089 00

Advertisement

Table of Contents
loading

Related Manuals for Gira S1

Summary of Contents for Gira S1

  • Page 1 Product documentation Status of the documentation: 10.08.2020 Gira S1 Order No. 2089 00...

  • Page 2: Table Of Contents

    1.1. Installation (see Chapter 6) ....................4 1.2. Configuration in the ETS (see Chapter 7) ................4 1.3. Configuration in the Gira Device portal (see Chapter 9) ............4 1.4. Configuration of access to the application (see Chapter 9.7) ..........4 2.
  • Page 3 9.9. Portal user administration ....................46 10.Gira S1 Windows client ........................49 10.1.Installation..........................49 10.2.Connecting to the Gira Device portal ...................50 10.3.Configuring the access options of a Gira S1 ................52 10.4.Ending a remote access connection ..................59 11.Technical data ..........................60 11.1.Accessories .......................... 60 12.Frequently asked questions (FAQs) ....................61...

  • Page 4: Configuration Of The Gira S1 At A Glance

    Gira S1 • the network connection. 1.2. Configuration in the ETS (see Chapter 7) • Create the Gira S1 as a device in the ETS. • Assign the physical addresses for the Gira S1. • Assign the required group addresses.

  • Page 5: Product Description

    The card memory can be used as a ring memory or as a ROM. • As a clock, the Gira S1 can send the time and date to the bus at configurable intervals. It is possible to trigger the sending of the current time and the current date via a trigger.

  • Page 6: Knx Secure Ready

    (see chapter 2.5 “Client software (Gira S1 Windows client)”). If you have a KNX installation in your house, you can connect it to the Gira S1 using the KNX connec- tion if desired. As a result, the KNX devices can be accessed from anywhere, e.g. with the ETS.

  • Page 7: Gira Device Portal

    You manage your Gira S1 using the Gira Device portal (https://geraeteportal.gira.de). Through the Gira Device portal, you can also provide other users with access to your Gira S1 and hence to the KNX and network devices in your home network.

  • Page 8: Client Software (Gira S1 Windows Client)

    Gira Device portal for the Gira S1. To save you from having to remember links, the Gira Device portal manages a list of links of the end devices, which you can access at httpaccess.net. If the network device supports UPnP, the Gira Device portal can enter it automatically in the list of links.

  • Page 9: Application Scenarios

    In conjunction with the Gira X1, the building functions can be controlled using secure remote access with the Gira X1 app. The programming or maintenance of the Gira X1 using the Gira Project Assistant (GPA) can also be carried out via the secure remote access.

  • Page 10: Configuration And Control Of The Gira Homeserver

    3.2. Configuration and control of the Gira HomeServer Access to the Gira HomeServer works in a similar way to access to the KNX installation. On the one hand, the KNX installation is accessed via the Gira HomeServer using the Eiblib/IP protocol, while on the other hand, the configuration is supported with the Expert.

  • Page 11: Access To Knx Installations

    ETS. In addition, it is also possible to make only the KNX/IP interface of the Gira S1 available for the sake of simplicity. In addition to the KNX/IP interfaces, all devices that can be loaded directly via IP (see chapter “Accelerate transfer: Select transfer path IP”) are made known to the ETS...

  • Page 12: Access To Websites On The Remote Network

    3.3.1. Limitations and authorisation of access rights via KNX communication objects If the Gira S1 is added to an ETS project, its communication objects can be used to prohibit or allow access options via KNX, even at runtime. The access rights limitations defined via the KNX in the remote installation always take precedence over the definitions in the portal.

  • Page 13: Access Via Other Tcp Protocols

    • The Gira S1 is configured using the parameters in the ETS in such a way that the users with the “residents” user group always have access; in addition, the users in the “installer” user group have access by default.

  • Page 14: Time Server

    4. Time server As a time server, the Gira S1 can send the current time to the KNX bus at configurable intervals. For this, first you activate the "Time server" parameter in the "General" parameter view so that the param- eter page “Time server”...

  • Page 15: Data Logger

    (~) is attached to the end of the file name, for further repetitions, consecutive numbers (~1) are added to the tilde. The Gira S1 supports SDHC cards up to a maximum of 32 GB. The cards must be formatted with FAT32. Important note To prevent damage to the card, you should deactivate logging before removing the microSD card.

  • Page 16: Access To The Data Logger Archive

    Data logger 5.1. Access to the data logger archive Via the device website, the data logger archive can be accessed. The menu item is also available when the datalogger is deactivated in order to download old files if necessary. In addition to the actual files, the status of the microSD card is also displayed.

  • Page 17: Installation

    2089 00 Gira S1 5. Operating LED (green): on = Gira S1 ready for operation flashing slowly = Gira S1 not yet parametrised or parametrised incorrectly flashing quickly = internal device error 6. KNX-LED (yellow) on = connection to KNX system...
  • Page 18 Installation 6.2.1. Mounting the device Observe the ambient temperature. Ensure sufficient cooling. • Snap the device onto a top-hat rail according to DIN EN 60715. See figure 1 for installation position. • Connect the external power supply to the connection terminal (3). Recommendation: Use white- yellow connection terminal.

  • Page 19: Configuration In The Ets

    Order No.: 2089 00 State of delivery Upon delivery or after a factory reset, the Gira S1 is configured as follows before it is loaded with ETS for the first time: • Remote access is activated for the “residents” user group •...

  • Page 20: Assigning Physical Addresses

    From ETS5 and higher, this is possible with any license. 7.2. Assigning physical addresses The Gira S1 has three tunnelling servers (KNX/IP interfaces). These interfaces can be used for down- loading and in the group and bus monitor modes. In addition to the device's physical address, the device also has (up to) three additional physical interfaces.

  • Page 21: Setting The Ip Address, Subnet Mask And Address Of The Default Gateway

    7.3. Setting the IP address, subnet mask and address of the default gateway In addition to the physical address on the KNX network, the Gira S1 must also be assigned an address on the IP data network. This includes the following information: •...

  • Page 22: Transferring Application Programs And Configuration Data

    Configuration in the ETS 7.4. Transferring application programs and configuration data Once you have programmed the physical address, you can transfer the application program, param- eter settings and group address connections to the device. You can create the connection to the device via IP or KNX.

  • Page 23: Parameters

    "Generic Time Zone w/o DST" time zones must be selected so that no automatic time changeovers are carried out. Important note: If this setting is changed, the Gira S1 will restart directly after the application has been programmed! Important note: The option to disable NTP via the device website has been deactivated since firm- ware version 5.0.
  • Page 24 Configuration in the ETS Parameters Entry / Selection Remarks Remote access for the as before restart After a restart, the remote access status of the “residents” or respective group is set to the last known value “installer” groups after before the restart. For example, if the remote restart access status is activated before the restart, the remote access status is also activated after a...
  • Page 25 Configuration in the ETS 7.5.3. Parameter page Data logger The parameter page Data logger is only visible when the data logger is activated on the parameter page General. Parameters Entry / Selection Remarks Format This parameter determines which format the data should be logged in on the microSD card.
  • Page 26 Configuration in the ETS Parameters Entry / Selection Remarks Basis of threshold value Value per dropdown list Factor by which the threshold value will be multi- plied, if required. 1: not a factor. Always generate notifi- Filter For the Bool (DPT 1.001) data type, the filter is pos- cation sible via a selection list.

  • Page 27: Object Table

    This means that the corresponding group objects that signal an active connec- tion also do not signal closing until this point in time. In contrast, if using the Gira S1 Windows client, the connection is closed synchronously.
  • Page 28 Connection error Data type: Alarm Function: Indicates a connection error, which is described by communication object 32. Fur- ther details can be found on the diagnostic page of the Gira S1. Description: 1 = Alarm, 0 = No alarm Object Name...
  • Page 29 Configuration in the ETS Object Name Direction Data width DP type Flags (CRWTU) Connection error info Read 14 bytes 16.001 CR-T- Category: Connection error Data type: Character (ISO 8859-1) Function: Additional diagnostic information in case of a portal connection error. Description: Supplies more precise information on the connection error displayed by commu- nication object 30.
  • Page 30 Configuration in the ETS Object Name Direction Data width DP type Flags (CRWTU) NTP status Read 1 bit 1.002 CR-T- Category: Time server Data type: Boolean Function: Indicates whether a valid time could be requested by the NTP server. Description: 1-bit object for display of the status of the last NTP query.
  • Page 31 Configuration in the ETS Object Name Direction Data width DP type Flags (CRWTU) SD card memory state Read 1 bit 1.002 CR-T- Category: Data logger Data type: Boolesch Function: Indicates if the SD card memory is exhausted (1 = full). Description: 1-bit object for display of the occupancy level of the SD card.
  • Page 32 Configuration in the ETS Object Name Direction Data width DP type Flags (CRWTU) 101 - 150 Notification Write 2 bytes C-W-- Category: Floating point Data type: KNX floating point Function: Sends a notification to the portal server. Description: This is one of five possible DP types for the 50 communication objects “101 to 150”.

  • Page 33: Displays And Operation

    2 s Note: intervals No remote access allowed. The device does not connect to the Gira Device portal; remote access is technically impossible. flashes slowly three Note: times at 2 s intervals Remote access is allowed for at least one group and there is at least one active connection.

  • Page 34: Factory Reset

    • Click the gear symbol in the selected line and select the “Factory reset” entry in the menu that opens. • In the dialog that opens, enter the device password of the Gira S1. You can find the password on a sticker on the device.

  • Page 35: Firmware Update Of The Device

    8.3.2. Firmware update using the diagnostic page The Gira S1 provides an option for installing firmware updates using the diagnostic page. To do so, click “Update firmware” on the diagnostic page. The Gira S1 now searches the update server auto- matically for a newer version and displays the current firmware version as well as the version of any available updates.

  • Page 36: Using The Gira Device Portal

    You can access the Gira Device portal at the following secure address: https://geraeteportal.gira.de. 9.1. Start page On the start page of the Gira Device portal, you must first log in with your user data to obtain corre- sponding access to configuration settings.

  • Page 37: Device Overview

    Using the Gira Device portal 9.2. Device overview Once you have logged in to the Gira Device portal, you see a list of all the devices linked to your user account. When you log in for the first time, this list is usually empty.

  • Page 38: Registering A Gira S1

    5. Give your device a name and enter a location. 6. Click “Next” and accept the terms of use. 7. Once you have successfully registered your Gira S1, the overview page for the Gira S1 opens. The following options are available here: •...

  • Page 39: Links

    Simple Service Discover Protocol (or SSDP for short) is used here. Using the “Manually add link” dialog, you can add links to devices that are not found automatically and save them to the list. Figure 10: Gira Device portal – Access to HTTP websites Order No. 2089 00 Page 39...

  • Page 40: Notifications

    Using the Gira Device portal 9.5. Notifications The “Notifications” area displays all messages for a Gira S1 sorted in chronological order. You can open any attachments, such as camera images, directly using a link. You can also forward these messages according to configurable rules (see chapter 9.8 “Configuring notifications”).

  • Page 41: Device Data

    A text field appears in the “Location” line, which can be assigned by the user as desired. The location is a property on the Gira S1 and is therefore the same for all users. The description can be entered by any user linked to the Gira S1.

  • Page 42: Access To Applications

    Software access, such as visualisations, is controlled using activation codes. Each user can create any number of codes on each Gira S1 to which he/she has access, e.g. for visualisation. For every activation code generated, a text field is available which describes the use of the code. You can delete the activation codes at any time (e.g.
  • Page 43 6. Enter the remote access ID and the activation code and click “Connect”. Note The connection provided via the Gira Project Assistant is available to all participants on the same net- work as the computer with the Gira Project Assistant.

  • Page 44: Configuring Notifications

    Figure 14: Gira Device portal – Receiving notifications 9.8.1. System messages You can record system events such as the logging in/logging out of a Gira S1 to/from the portal and the access to the remote network via an app. 9.8.2. Notifications via KNX The purpose of notifications is to save information from the installation, e.g.
  • Page 45 • Save the forwarding rule. It is activated automatically. Note The notifications generated by the system, e.g., for online/offline status of the Gira S1, are always generated with the “System” severity and “Remote access” category. All severities up to “System”...

  • Page 46: Portal User Administration

    “residents” and “installer”, whereby a user can be assigned to neither group or to both groups. Besides adding new users to a Gira S1, you can also further restrict user rights or delete the connection of a Gira S1 to a user.
  • Page 47 The owner of a Gira S1 can take away all rights of all other users at any time, including other admin- istrators, whereas no one can deny him or her access.
  • Page 48 Using the Gira Device portal 3. When both the new owner and the current owner have accepted the transfer, both receive a cor- responding e-mail and ownership is transferred. If the request is not confirmed by the new owner or the current owner, no transfer of ownership takes place.

  • Page 49: Gira S1 Windows Client

    10. Gira S1 Windows client The Gira S1 Windows client is an application that is installed on a computer, which can be used to access devices on the remote network securely over the Internet if the HTTP protocol is not used. The Gira S1 Windows client is not required for accessing websites on the remote network using a web browser, see chapter 3.4 “Access to websites on the remote network”.

  • Page 50: Connecting To The Gira Device Portal

    Figure 17: Gira S1 Windows client login Log in here using the login data from the Gira Device portal. In other words, enter your portal user name (note: this is always an e-mail address) and the associated password, and click “Login”.
  • Page 51 Figure 18: Displaying the available Gira S1 devices Connecting to the Gira S1 If you select a Gira S1 in the list, you can either click “Connect” to connect to the Gira S1 or click “Configure” to change the configuration of the Gira S1.

  • Page 52: Configuring The Access Options Of A Gira S1

    If you are connected to the Gira S1, you can click “Configure” to configure the access options. In addition to HTTP access, for which a Gira S1 Windows client is not required, the standard use of the Gira S1 is to access KNX installations remotely and securely using the KNX/IP protocol. The con- figuration for this service is therefore always visible and activated by default.
  • Page 53 Always use Gira S1 only for KNX access If desired, you can also make only the tunnelling server of the Gira S1 accessible via remote access, e.g. because many devices are available on the remote network and you are in a hurry.
  • Page 54 Figure 21: Manual KNX/IP interface configuration for ETS older than ETS4.2. Note The Gira S1 Windows client remembers the locally used port (starting with 35000) for each tunnelling server from the remote network so that the connections created manually remain valid later on for a new remote access connection to the same installation.
  • Page 55 Figure 22: Gira HomeServer remote access configuration. Gira HomeServer IP or DNS name To ensure secure remote access to the Gira HomeServer, you must enter the IP address or local DNS name of the Gira HomeServer in the installation, i.e. the remote network.
  • Page 56 Eiblib/IP protocol by default, which means that you do not generally have to make any changes here. To use Eiblib/IP with the Gira HomeServer, you must create a connection of the “Eiblib/IP” type in the ETS as before. As with the Expert, the server address 127.0.0.1 must always be entered here. The ports can usually retain their default values (50000, 50001 and 50002).
  • Page 57 Gira S1 Windows client Figure 24: Using the Gira HomeServer with Eiblib/IP via remote access for KNX connection. Order No. 2089 00 Page 57...
  • Page 58 Gira S1 Windows client 10.3.3. Using other TCP protocols via remote access Using the settings in “TCP remote access connections”, you can use other TCP-based IP protocols via remote access. To do so, click “Add” and enter the corresponding values for the remote access.

  • Page 59: Ending A Remote Access Connection

    Create two connections with the two ports, HTTP (80) and 8080. Enter the IP address of the corre- sponding DCS-IP gateway. Once a remote access connection to Gira S1 has been established, you can call up the DCS-IP gate- way assistant by entering the address http://localhost:80 into the address line of your browser.

  • Page 60: Technical Data

    Technical data 11. Technical data KNX medium Start-up mode S mode (ETS) KNX supply DC 21…30 V SELV KNX current consumption type 2.5 mA KNX connection Bus connection terminal External supply Voltage DC 24...30 V Power consumption 2 W (at DC24 V) Connection Connection terminal IP communication...

  • Page 61: Frequently Asked Questions (Faqs)

    • When downloading the application program, why does ETS report the error that data cannot be written to a protected area? Please make sure that your ETS version is up to date. Gira S1 requires ETS from version 4.2 or 5.0.2, or higher.
  • Page 62 Please never download the device as a partial download using ETS4. Instead, always carry out an application download. This problem does not exist in ETS5. • After unloading the application on the device website of the Gira S1, why do I still see the previously configured physical address and IP address? After unloading an application, the device website is not currently updated until the device has been restarted.

  • Page 63: Troubleshooting And Support

    Gira Device portal as online? Check the device website for other error infor- mation. Check the configuration and status of the user groups in the Gira Device portal and on the Restart the device via the device website. device website. Order No. 2089 00...

  • Page 64: Gira S1 Device Website

    Calling up the device website If you know the IP address of the Gira S1, you can call up the device website by entering the IP address in the address line of a web browser (Chrome, Firefox...). To do this, the PC must be on the same network as the Gira S1.

  • Page 65: License Agreement

    Licensor: Gira, Giersiepen GmbH & Co KG, Radevormwald, Germany Licensee: The legal recipient of the Gira S1 device software. Gira S1 devices: The term Gira S1 devices refers to the Gira S1 devices that each consist of a hardware device and the associated firmware.
  • Page 66 The license texts of the GPL and LGPL are available via the following web page: http://www.gnu.org/ licenses/licenses.html 2. Licensed property The subject matter of this agreement is the software provided on the Gira S1, as well as the corre- sponding documentation in written or electronic form. Order No. 2089 00...
  • Page 67 4.3. The license for Gira S1 software is bound to the use of the Gira S1 device. It is only permitted to transfer the Gira S1 software to third parties or provide third parties with access to the software in conjunction with the transfer of the Gira S1 devices.
  • Page 68 The licensor shall charge the licensee the shipping costs for this. 7.1. The Gira S1 software and the documentation (which shall be provided in printed form or also as online help or online documentation) shall be provided to the licensee in the respective valid version.
  • Page 69 No claim to reimbursement of the price paid shall be accepted in this case. The license for use of the Gira S1 software shall expire upon the termination of the agreement. In this case, the Gira S1 devices must be taken out of operation. Further use of the Gira S1 devices without a license is prohibited.

This manual is also suitable for:

2089 00

Table of Contents