atrea_control 1.3.0 → 2.0.1

data/config/locales/de.yml

@@ -0,0 +1,269 @@
+---
+de:
+  mainTitle: Ihr Spezialist für Lüftung mit Wärmerückgewinnung
+  save: Speichern
+  cancel: Abbrechen
+  copy: Kopieren
+  refresh: Überschreiben
+  change: Übernehmen
+  pleaseWait: Bitte warten
+  backToHome: Zurück zur Startseite
+  mainPage: Startseite
+  serviceMenu: Service Menü
+  activeFrom: Aktiv
+  hours: Analog
+  minutes: Minuten
+  record: Eintrag
+  allowed: Ermöglicht
+  netSetup: Netzeinstellungen
+  getFromDHCP: DHCP Einstellung
+  useNextValues: Folgende Einstellungen verwenden
+  addressIP: IP Addresse
+  subnetMask: Subnet Maske
+  defaultGW: Gateway
+  serverDNS: DNS Server
+  FTPsetup: FTP Server Passwort
+  passwordOld: 'Original Passwort '
+  passwordNew: Neues Passwort
+  passwordConfirm: Password bestätigen
+  airCond: Lüftungsgerät
+  airCondSetup: Geräte Einstellungen
+  temperature: Temperatur
+  tempSetup: Temperatur Einstellungen
+  notInDemo: Demoversion wird nicht unterstützt
+  thisTimeExist: Zeitvorgabe existiert bereits
+  serviceSetup: Service Einstellungen
+  activeAlarms: Aktive Alarme
+  alarmHistory: Alarm Historie
+  unitStarted: Anlauf
+  active: Aktiv
+  noAlarmDefined: Kein Alarm definiert
+  noAlarmDetected: Keine aktiven Alarme
+  values: Wert
+  parameters: Parameter
+  badInput: Falsche Eingabe
+  allowedRange: Erforderlicher Bereich
+  start: Start
+  stop: Stop
+  text: Text
+  digiVer: DIGI Module Version
+  rdVer: RD Module Version
+  unitAddress: Geräte Adresse
+  currentMode: Aktueller Modus
+  damageWarning: Achtung! Bei falscher Einstellung dieser Parameter, besteht die Möglichkeit,
+    dass das Gerät nicht richtig arbeitet. Für Schäden, die durch falsche Einstellung
+    entstehen, übernimmt der Hersteller keine Haftung!
+  parameter: Parameter
+  value: Wert
+  minimum: Minimum
+  maximum: Maximal
+  defValue: Standard Wert
+  warning: Warnung
+  error: Eingeben
+  accessPrompt: Geben Sie bitte den Service-Code ein
+  accessDenied: Zugriff verweigert, falscher Code
+  swVer: Software Version
+  orderNum: Produktionsnummer
+  userSetup: Benutzereinstellungen
+  switchman: Manuell
+  valueOutOfRange: Der Wert liegt außerhalb des Bereichs
+  fwStep1: Schritt 1 - Speichern der Parameter
+  fwStep2: Schritt 2 - Firmware Update
+  fwSTep3: Schritt 3 - Aktualisierung
+  saveSettings: Speichern der Parameter
+  updateIt: Updaten
+  restoreSettings: Wiederherstellen der Parameter
+  parsNotSaved: Parameter wurden nicht gespeichert
+  errLengthCoo: Fehler! - Bitte verwenden Sie einen anderen Browser
+  parsSaved: Parameter wurden gespeichert
+  updateInProcess: Update, bitte warten...
+  updateNoFile: Datei wurde nicht gefunden...
+  updateSucess: Update war erfolgreich!
+  updateError: Störung - Update
+  manControlOn: Manuelle Eingabe aktiv!
+  manControlOff: Manuelle Eingabe deaktiviert
+  notConnected: Nicht angeschlossen
+  PgFW_FS1: Backup Einstellungen wiederherstellen
+  PgFW_S1: Backup Serviceeinstellungen
+  PgFW_SB1: Backup
+  PgFW_S2: Serviceeinstellungen wiederherstellen
+  PgFW_SB2: Überschreiben
+  PgFW_S3: Werkseinstellungen wiederherstellen
+  PgFW_SB3: Überschreiben
+  PgFW_FS2: Update
+  PgFW_U2: Download Update Anwendungen
+  PgFW_UB1: Öffnen
+  PgFW_SB1c: Möchten Sie wirklich ein Backup der Serviceeinstellungen durchführen?
+  PgFW_SB2c: Möchten Sie wirklich die Serviceeinstellung wiederherstellen?
+  PgFW_SB3c: Möchten Sie wirklich die Standardeinstellungen wiederherstellen?
+  fwUnit: Vorhandene FW
+  fwAvail: Verfügbare FW
+  restInProgress: Parameter werden wiederhergestellt
+  restart: Neustart
+  activate: Aktivieren
+  deactivate: Deaktivieren
+  badTimeZone: Falsche Zeitzone
+  badTime: Falsche Zeiteinstellung
+  setByPC: Einstellen nach PC
+  msgFindAddr: Geben Sie eine neue Geräteadresse ein
+  dtFilterChange: Nächst. Filterwechsel
+  confirmFilter: Filter gewechselt
+  confFilterQuest: Wurden die Filter gewechselt?
+  'off': Aus
+  'on': Ein
+  dayOfWeek: Wochentag
+  monday: Montag
+  tuesday: Dienstag
+  wednesday: Mittwoch
+  thursday: Donnerstag
+  friday: Freitag
+  saturday: Samstag
+  sunday: Sonntag
+  medium: Mittlerer
+  night: Nacht
+  day: Tag
+  power: Luftleistung
+  automatic: Wochenprogramm
+  manual: Manuell
+  temporary: Vorübergehend
+  non: Keine
+  mode: Betriebsmodus
+  perVentilation: Periodische Lüftung
+  ventilation: Lüftung
+  circulation: Umluft
+  startUp: Anlauf
+  runDown: Auslauf
+  defrosting: Enteisung
+  external: Extern
+  inactive: Aus
+  zone: Lüftungszone
+  heating: Heizsaison
+  nonHeating: Nichtheizsaison
+  dateTime: Datum/Uhrzeit
+  filterChange: Filtertausch
+  notWhenAuto: Wenn die Temperatursteuerung im Automatik Modus läuft, ist dei momentane
+    Einstellung nur bis zum nächsten Wochenprogramm Intervall gültig.
+  heatingSched: Wochenprogramm - Heizsaison
+  nonHeatingSched: Wochenprogramm - Nichtheizsaison
+  userSetting: Benutzereinstellungen
+  season: Saison
+  modeAC: Lüftungsmodus
+  modeTemp: Temperaturmodus
+  controlSetting: Regelungsparameter
+  tempSenzorDev: Korrektur Raumtemperatur Sensor
+  inputBlock: Blockierung IN1/IN2
+  personsCount: Anzahl der Personen
+  thermostatFcn: Funktion Temperaturwächter
+  holidayParty: Urlaub / Party
+  texts: Bezeichnungen
+  txtZone1: Zone 1
+  txtZone2: Zone 2
+  txtZone12: Zone 1 2
+  swInfo: Software Information
+  alarms: Alarme
+  controlAC: Lüftungsregelung
+  controlTemp: Temperaturregelung
+  currentPower: Aktuelle Leistung
+  requiredPower: Ausgewählte Leistung
+  requiredTemp: Ausgewählte Temperatur
+  requiredMode: Ausgewählter Modus
+  indoorTemp: Raumtemperatur
+  inletTemp: Zulufttemperatur
+  czech: Tschechisch
+  german: Deutsch
+  english: Englisch
+  eqVent: Konstant Volumenstrom Modus
+  ventCirc: Lüftung mit Zirkulation
+  circDepend: Zirkulations intervall
+  overPrVent: Überdruck Lüftung
+  devHeating: Korrektur Abweichung Heizung
+  devCooling: Korrektur Abweichung Kühlung
+  devCoolMax: Maximale Temperaturabweichung für maximale Kühlung
+  productNumber: Produktionsnummer
+  unitType: Gerätetyp
+  polish: Polnisch
+  bySens: Automatik
+  hpDefrosting: Enteisung Nachheizregister PWW
+  userLogin: Benutzeranmeldung
+  passwordInput: Passwort eingeben
+  loginCmd: einloggen
+  weeklyProgram: Wochenprogramm
+  italiano: Italienisch
+  nightBefCool: Nachtkühlung
+  passwordMenu: Ändern des Passworts
+  enterAllFields: Geben Sie alle Daten
+  passwordNoChk: Neues Passwort und Bestätigung stimmen nicht überein!
+  passwordBad: Passwort darf nur aus folgenden Zeichen a-z  or A-Z or 0-9 bestehen!
+  passwordSaved: Passwort wurde gespeichert
+  passwordSaveErr: Passwort wurde  - errornicht gespeichert - Fehler.
+  unavail: nicht verfügbar
+  disabledRange: 'Unzulässige Auswahl '
+  emergMode: Notlauf-Funktion
+  outdoorTemp: Aussen Temperatur
+  currentZone: Aktueller Zone
+  components: Komponenten
+  all: Alles
+  modeAuto: Automatik
+  disbalance: Disbalance
+  saveActive: Speichern / Aktivieren
+  holidays: Feiertag
+  vacations: Ferienzeit
+  unitDesign: Konstruktion
+  unitSpec: Spezifikation
+  partyStart: Start
+  partyEnd: Ende
+  tsNtsSwitch: HS/NHS Schaltung
+  tsNtsTemp: HS/NHS Temperatur
+  in1Block: IN1 Eingang  Deaktivieren
+  in2Block: IN2 Eingang  Deaktivieren
+  hystHeat: Vol. Steigerüng Kühlung
+  hystCool: Vol. Steigerüng Heitzung
+  set: Einstellen
+  timeZone: Zeit Zone
+  settingTZ: Time zone setting
+  producer: Lieferant
+  unitLine: Serie
+  unitSize: Gereatgrosse
+  unitIntDesign: Spezifikationen
+  currentConfig: Aktueller Einstellung
+  monthName1: Januar
+  monthName2: Februar
+  monthName3: März
+  monthName4: April
+  monthName5: Mai
+  monthName6: Juli
+  monthName7: Juli
+  monthName8: August
+  monthName9: September
+  monthName10: Oktober
+  monthName11: November
+  monthName12: Dezember
+  holidayTip: Feiertag/Ferienzeit
+  prodCodeInput: Geben Sie den Lieferanten Code ein...
+  logType: Typ
+  current: Aktuell
+  week: Woche
+  month: Monat
+  selectDay: Wählen Sie einen Tag
+  show: Anzeige
+  dataNotFound: Daten wurden nicht gefunden
+  logLive: Eingeschaltet
+  holidayVacation: Feiertag und Ferienzeit
+  timeAutoSwitch: DST automatisch
+  timeSyncInet: Zeit mit Internet synchronisieren
+  unitTime: Gerätezeit
+  inputs: Eingänge
+  outputs: Ausgänge
+  others: Andere
+  heatIconTip: Heizung aktiviert
+  coolIconTip: Kühlung aktiviert
+  partyIconTip: Modus Party/Urlaub aktiviert
+  alarmIconTip: Aktiver Alarm
+  PgFW_S2A: Letzte Datensicherung
+  reset: Reset
+  commun: Kommunikation
+  serverPing: Funktion "Connect server"
+  acsService: Servicezugang
+  acsDistr: Lieferantenzugang
+  lastCommun: Letzte Kommunikation
+  unitName: Jméno jednotky

data/config/locales/en.yml

@@ -0,0 +1,269 @@
+---
+en:
+  mainTitle: Your specialist for heat recovery and air-handling system economy
+  save: Save
+  cancel: Cancel
+  copy: Copy
+  refresh: Restore
+  change: Change
+  pleaseWait: Wait, please...
+  backToHome: Back to main page
+  mainPage: Main page
+  serviceMenu: Service menu
+  activeFrom: Active from
+  hours: Analog
+  minutes: Minutes
+  record: Record
+  allowed: Allowed
+  netSetup: Network setting
+  getFromDHCP: DHCP parameters setting
+  useNextValues: Use the following setting
+  addressIP: IP address
+  subnetMask: Net mask
+  defaultGW: Gateway
+  serverDNS: DNS server
+  FTPsetup: FTP server password
+  passwordOld: 'Original password '
+  passwordNew: 'New password '
+  passwordConfirm: Password confirmation
+  airCond: Air handling unit
+  airCondSetup: HVAC unit configuration
+  temperature: Temperature
+  tempSetup: Temperature setting
+  notInDemo: Demo version does not support
+  thisTimeExist: Set time already exists
+  serviceSetup: Service setting
+  activeAlarms: Active alarms
+  alarmHistory: Alarm history
+  unitStarted: Unit start
+  active: Active
+  noAlarmDefined: No alarm defined
+  noAlarmDetected: No alarm is active
+  values: Values
+  parameters: Parameters
+  badInput: Wrong value inserted
+  allowedRange: Required values range
+  start: Start
+  stop: Stop
+  text: Text
+  digiVer: DIGI module version
+  rdVer: RD module version
+  unitAddress: Address of unit
+  currentMode: Current mode
+  damageWarning: 'Attention! When setting following parameters, be carefull about
+    the set values, inadequate setting may cause malfunction of the Unit. The appliance
+    producer is not responsible in any case of harm! '
+  parameter: Parameter
+  value: Value
+  minimum: Minimum
+  maximum: Max
+  defValue: Default
+  warning: Warning
+  error: Set
+  accessPrompt: Access check, enter the service code!
+  accessDenied: Access denied, wrong code!
+  swVer: Software version
+  orderNum: Production number
+  userSetup: User setting
+  switchman: Manual
+  valueOutOfRange: Value exceeded the range
+  fwStep1: Step 1 - Save parameters
+  fwStep2: Step 2 - Firmware update
+  fwSTep3: Step 3 - Parameters refresh
+  saveSettings: Save parameters
+  updateIt: Make update
+  restoreSettings: Refresh parameters
+  parsNotSaved: No parameters has been saved till now
+  errLengthCoo: Data error, use different browser
+  parsSaved: Parameters have been saved
+  updateInProcess: The update is in progress, wait please.
+  updateNoFile: No file for update has been found
+  updateSucess: UPDATE finished
+  updateError: Update error
+  manControlOn: Manual control enabled
+  manControlOff: Manual control disabled
+  notConnected: Not connected
+  PgFW_FS1: Restore/back-up setting
+  PgFW_S1: The backup of the service setting
+  PgFW_SB1: Back-up
+  PgFW_S2: Service setting restore from back-up
+  PgFW_SB2: Restore
+  PgFW_S3: 'Restore to production setting '
+  PgFW_SB3: Restore
+  PgFW_FS2: Update
+  PgFW_U2: Download of the update application
+  PgFW_UB1: Open
+  PgFW_SB1c: Do you wish to make a back-up of the service setting?
+  PgFW_SB2c: 'Are you sure to restore service setting from the back-up file? '
+  PgFW_SB3c: Are you sure to restore the default setting?
+  fwUnit: Current fw ver.
+  fwAvail: Available fw ver.
+  restInProgress: Setting restore is in the progress
+  restart: Restart
+  activate: Activate
+  deactivate: Deactivate
+  badTimeZone: Wrong time zone
+  badTime: Wrong time setting
+  setByPC: Set according to the PC
+  msgFindAddr: Enter a new unit address.
+  dtFilterChange: Next filter change
+  confirmFilter: Confirm the change
+  confFilterQuest: Are you sure the filter has been changed?
+  'off': 'Off'
+  'on': 'On'
+  dayOfWeek: Day of week
+  monday: Monday
+  tuesday: Tuesday
+  wednesday: Wednesday
+  thursday: Thursday
+  friday: Friday
+  saturday: Saturday
+  sunday: Sunday
+  medium: Medium
+  night: Night
+  day: Day
+  power: Power
+  automatic: Schedule
+  manual: Manual
+  temporary: Temporary
+  non: Non
+  mode: Mode
+  perVentilation: Period. ventilation
+  ventilation: Ventilation
+  circulation: Circulation
+  startUp: Start-up
+  runDown: Run-out
+  defrosting: Defrosting
+  external: External
+  inactive: 'Off'
+  zone: Zone
+  heating: Heating
+  nonHeating: Non-heating
+  dateTime: 'Time and date '
+  filterChange: Filter change
+  notWhenAuto: Temperature control set to the Automatic mode, the current setting
+    is valid till the next week interval is active.
+  heatingSched: Heating season schedule
+  nonHeatingSched: Non-heating season schedule
+  userSetting: User setting
+  season: Season
+  modeAC: Mode air-handling
+  modeTemp: Temperature mode
+  controlSetting: Control procesor setting
+  tempSenzorDev: Temperature sensor correction - CP
+  inputBlock: IN Blocking
+  personsCount: Number of persons
+  thermostatFcn: Thermostat function
+  holidayParty: Holiday / party
+  texts: Texts
+  txtZone1: Text for zone 1
+  txtZone2: Text for zone 2
+  txtZone12: Text for zone 1 and 2
+  swInfo: About the control
+  alarms: Alarms
+  controlAC: Air-handling control
+  controlTemp: Temperature control
+  currentPower: Actual Power
+  requiredPower: Requested power
+  requiredTemp: Requested temperature
+  requiredMode: Requested mode
+  indoorTemp: Inner temperature
+  inletTemp: Supply air temperature
+  czech: Czech
+  german: German
+  english: English
+  eqVent: Equal volume flow
+  ventCirc: Ventilat. circulation
+  circDepend: Interval circulation
+  overPrVent: Overpressure
+  devHeating: Temperature hysteresis - heating
+  devCooling: Temperature hysteresis - cooling
+  devCoolMax: Max. temperature drop - max. cooling
+  productNumber: Production number
+  unitType: Unit type
+  polish: Polish
+  bySens: Auto - ventilation
+  hpDefrosting: HP defrosting
+  userLogin: User login
+  passwordInput: Enter the password
+  loginCmd: Login
+  weeklyProgram: Schedule
+  italiano: Italian
+  nightBefCool: Night precooling
+  passwordMenu: Password change
+  enterAllFields: Fill all the data
+  passwordNoChk: A new password and the confirmation does not match!
+  passwordBad: The password may only consist of figures a-z  or A-Z or 0-9!
+  passwordSaved: The password has been saved
+  passwordSaveErr: Password was not saved - error.
+  unavail: Unavailable
+  disabledRange: Range is exceeded
+  emergMode: Emergency mode
+  outdoorTemp: Outdoor temperature
+  currentZone: Actual zone
+  components: Components
+  all: All
+  modeAuto: Automat
+  disbalance: Disbalance
+  saveActive: Save / Activate
+  holidays: Bank Holidays
+  vacations: Vacations
+  unitDesign: Design
+  unitSpec: Specification
+  partyStart: Starts at...
+  partyEnd: Expires at...
+  tsNtsSwitch: HS/NHS switching
+  tsNtsTemp: HS/NHS switch temp.
+  in1Block: IN1 input blocking
+  in2Block: IN2 input blocking
+  hystHeat: Hysteresis - heating
+  hystCool: Hysteresis - cooling
+  set: Set new
+  timeZone: Time zone
+  settingTZ: Time zone setting
+  producer: Supplier
+  unitLine: Line
+  unitSize: Unit size
+  unitIntDesign: Specification
+  currentConfig: Current setting
+  monthName1: January
+  monthName2: Fabruery
+  monthName3: March
+  monthName4: April
+  monthName5: May
+  monthName6: June
+  monthName7: July
+  monthName8: August
+  monthName9: September
+  monthName10: October
+  monthName11: November
+  monthName12: December
+  holidayTip: Bank holid./Vacation
+  prodCodeInput: Enter the supplier code...
+  logType: Log typ
+  current: Current
+  week: Week
+  month: Month
+  selectDay: Choose the week day
+  show: Show...
+  dataNotFound: Data are not found
+  logLive: On-line
+  holidayVacation: Bank holidays, Vacation
+  timeAutoSwitch: DST automaticaly
+  timeSyncInet: Internet time synchronisation
+  unitTime: Unit time
+  inputs: Inputs
+  outputs: Outputs
+  others: Others
+  heatIconTip: 'Heating activated '
+  coolIconTip: Cooling activated
+  partyIconTip: Party/Holiday mode activated
+  alarmIconTip: Activ alarm
+  PgFW_S2A: Last backup
+  reset: Reset
+  commun: Communication
+  serverPing: '"Connect server" service'
+  acsService: Service access
+  acsDistr: Distributor access
+  lastCommun: Last communication
+  unitName: Jméno jednotky

data/lib/atrea_control/duplex/login.rb

@@ -0,0 +1,107 @@
+require "selenium-webdriver"
+
+module AtreaControl
+  module Duplex
+    # Process login into RD5 with selenium to get `sid` ( auth_token ) for direct API communication
+    class Login
+
+      include AtreaControl::Logger
+
+      # @return [Hash] - user_id, unit_id, sid
+      def self.user_tokens(login:, password:)
+        i = new(login: login, password: password)
+        tokens = i.user
+
+        tokens
+      ensure
+        i.close
+      end
+
+      # @param [String] login
+      # @param [String] password
+      def initialize(login:, password:)
+        @login = login
+        @password = password
+      end
+
+      def user
+        raise AtreaControl::Error, "Must be logged in" unless login
+
+        logger.debug "refresh user data based on session"
+        @user_id = driver.execute_script("return window._user")
+        @unit_id = driver.execute_script("return window._unit")
+        @auth_token = driver.execute_script("return window.user")&.[]("auth") # sid
+
+        { user_id: @user_id, unit_id: @unit_id, sid: @auth_token }
+      end
+
+      # @return [Selenium::WebDriver::Firefox::Driver]
+      def driver
+        return @driver if defined?(@driver)
+
+        options = Selenium::WebDriver::Firefox::Options.new
+        options.headless! unless ENV["NO_HEADLESS"]
+        @driver ||= Selenium::WebDriver.for :firefox, capabilities: [options]
+      end
+
+      # Login into control
+      def login
+        return driver if @logged
+
+        @login_in_progress = true
+        logger.debug "start new login..."
+        driver.get "#{AtreaControl::Duplex::CONTROL_URI}?action=logout"
+        submit_login_form
+        finish_login
+        driver
+      ensure
+        @login_in_progress = false
+      end
+
+      # Submit given credentials and proceed login
+      def submit_login_form
+        form = driver.find_element(id: "loginFrm")
+        username = form.find_element(name: "username")
+        username.send_keys @login
+        password = form.find_element(name: "password")
+        password.send_keys @password
+        logger.debug "Submit login form..."
+
+        submit = form.find_element(css: "input[type=submit]")
+        submit.click
+      end
+
+      # Retrieve dashboard URI from object tag and open it again
+      def open_dashboard
+        uri = driver.find_element(tag_name: "object").attribute "data"
+        # Open "iframe" with atrea dashboard - it propagate window objects...
+        driver.get uri
+        logger.debug "login success"
+        @logged = true
+      end
+
+      # quit selenium browser
+      def close
+        driver.quit rescue nil
+        logger.debug "driver closed & destroyed"
+      ensure
+        remove_instance_variable :@driver
+      end
+
+      private
+
+      def finish_login
+        30.times do |i|
+          return true if open_dashboard
+        rescue Selenium::WebDriver::Error::NoSuchElementError => e
+          logger.debug e.message
+          logger.debug "#{i + 1}/30 attempt for login..."
+          sleep 10
+        end
+        File.write("/tmp/failed_login-#{@login}.html", driver.page_source)
+        raise AtreaControl::Error, "unable to login"
+      end
+
+    end
+  end
+end

data/lib/atrea_control/duplex/request.rb

@@ -0,0 +1,30 @@
+require "rest-client"
+
+module AtreaControl
+  module Duplex
+    # Process request with duplex unit itself. Handle response
+    class Request
+      include AtreaControl::Logger
+
+      # @param [String, Integer] user_id
+      # @param [String, Integer] unit_id
+      # @param [String, Integer] sid
+      # @note `ver` is done by atrea server
+      def initialize(user_id:, unit_id:, sid:)
+        @params = {
+          _user: user_id.to_i,
+          _unit: unit_id,
+          auth: sid,
+          ver: AtreaControl::Duplex::CONTROL_VERSION,
+        }
+      end
+
+      # @param [Hash] params
+      # @option params [String] :_t ("config/xml.xml") file name
+      def call(params)
+        RestClient.get "#{AtreaControl::Duplex::CONTROL_URI}/comm/sw/unit.php", params: @params.merge(params)
+      end
+
+    end
+  end
+end