machine_setup 0.1.0 → 0.2.0

data/examples/underleaver/underleaver.setup.param.de.yml

@@ -6,6 +6,9 @@ de:
   drives:
     name: "Antriebe Underleaver"
 
+  role_configuration:
+    name: "Rollenerkennung"
+
   #parameter
   underleaver_config:
     name:  "Underleaver virtuell=1 / real=0"
@@ -24,19 +27,19 @@ de:
               1xx: Steuerung simuliert alle Antriebe
 
   distance_photo_sensor:
-    name:  "Weg Lichtschranke bis Blattaustritt"
-    comment:  "Abstand der Lichtschranke vom Blattaustritt. [mm]"
+    name:  "Weg Lichtschranke bis Blattaustritt [mm]"
+    comment:  "Abstand der Lichtschranke vom Blattaustritt. Angabe erfolgt in Millimeter."
 
   distance_photo_sensor_from_start:
-    name:   "Weg Bandbeginn bis Lichtschranke"
-    comment:  "Abstand der Lichtschranke vom Bandbeginn. [mm]"
+    name:   "Weg Bandbeginn bis Lichtschranke [mm]"
+    comment:  "Abstand der Lichtschranke vom Bandbeginn. Angabe erfolgt in Millimeter."
 
   distance_blade_to_sheet_drive:
-    name: "Weg Schneide bis Blattantrieb"
+    name: "Weg Schneide bis Blattantrieb [mm]"
     comment: ""
 
   distance_sheet_drive_to_sheet_exit:
-    name:  "Weg Blattantrieb bis Blattaustritt"
+    name:  "Weg Blattantrieb bis Blattaustritt [mm]"
     comment:  ""
 
   time_for_cutting_unit:
@@ -56,13 +59,13 @@ de:
               (Standard: 1)
 
   paper_jam_detection_signal_length:
-    name:  "Signaldauer f�r Papierstau"
+    name:  "Signaldauer f�r Papierstau [ms]"
     comment:  "Zeitdauer, ab der ein durchg�ngiges Signal vom Papierstausensor als Papierstau interpretiert wird.\n
                 Die Angabe erfolgt in Millisekunden, d.h. 5000 entspricht 5 Sekunden.\n
                 Bei Angabe von 0 wird die Zeitdauer programmintern festgelegt."
 
   paper_jam_detection_check_time:
-    name:  "Papierstau�berpr�fungszeit nach 'letztem' Produkt"
+    name:  "Papierstau�berpr�fungszeit nach 'letztem' Produkt [ms]"
     comment:  "Die �berpr�fung, ob ein Papierstau vorliegt, erfolgt bei Beginn der F�rderung des n�chsten Blattes.
               Kommt nach dem aktuellen Produkt eine Weile kein Produkt mehr, so erm�glicht dieser Parameter die Einstellung
               der Zeitdauer, nach deren Ablauf eine Papierstau�berpr�fung vorgenommen wird.\n
@@ -89,7 +92,7 @@ de:
               2: positives Dauersignal - Freigabe bei 12V"
 
   ext_enabling_following_unit_delay:
-    name:  "Konfiguration der Verz�gerung NE"
+    name:  "Konfiguration der Verz�gerung NE [ms]"
     comment:  "Konfiguration der Verz�gerung nach Freigabesignal. [in ms]\n
               \n
               X: Der Wert X bestimmt die Zeit, die der Underleaver wartet nachdem das Freigabesignal empfangen wurde. Erst nach Ablauf dieser Zeit f�rdert der Underleaver weiter."
@@ -102,6 +105,20 @@ de:
               1: negatives Dauersignal - Freigabe bei 0V\n
               2: positives Dauersignal - Freigabe bei 12V"
 
+  config_safety_circuit:
+    name: "Konfiguration des Sicherheitskreises"
+    comment: |
+              Mit Hilfe dieses Parameters lassen sich die Elemente im Sicherheitskreis der Maschine konfigurieren. Es werden nur Meldungen von angew�hlten Sicherheitskreiselementen ausgegeben.
+
+
+              Konfiguration des Eingangssignals NotHalt
+              0: nicht konfiguriert
+              1: eigener Not-Halt ist angebaut, Low-Signal bedeutet Not-Halt ist gedr�ckt
+              2: eigener Not-Halt ist angebaut, High-Signal bedeutet Not-Halt ist gedr�ckt
+              3: Eingang wird als 'Sicherheitskreis bereit' der leitenden Anlage bewertet - Low-Signal bedeutet Anlage nicht bereit
+              4: Eingang wird als 'Sicherheitskreis bereit' der leitenden Anlage bewertet - High-Signal bedeutet Anlage nicht bereit
+
+    
   source_parameter_working_velocity:
     name:     "Parameterquelle f�r Bandgeschwindigkeit"
     comment:  |
@@ -133,7 +150,7 @@ de:
               Standard: 1
   
   factor_activation_point_roll_bracket:
-    name:   "Faktor Aktivierungspunkt Rollenbremse"
+    name:   "Faktor Aktivierungspunkt Rollenbremse [%]"
     comment: |
               Faktor f�r den Aktivierungspunkt der Rollenbremse.
               
@@ -167,6 +184,133 @@ de:
 
           Der Wert wird in Millimeter angegeben.
 
+  dancer_pressure_algorithm:
+    name: "Algorithmus f�r die Druckberechnung des T�nzers"
+    comment: |
+          Mit diesem Parameter l��t sich der Algorithmus f�r die Druckberechnung des T�nzers festlegen.
+          Mit dem berechneten Druck wird der T�nzer nach unten bewegt.
+          Folgende Werte werden unterst�tzt:
+
+
+          0: Lineare Gleichung
+          1: Quadratische Gleichung
+          2: Polynom 5. Grades
+
+
+          Au�er dem Algorithmus haben die Werte f�r den oberen und unteren Teachpunkt des T�nzers sowie der
+          maximale Druck des Druckreglers Einflu� auf die T�nzerbewegung.
+
+  blade_rotate_proof_installable:
+    name: "Messer verdrehsicher einbaubar"
+    comment: |
+          Gibt Auskunft dar�ber, ob die Messerwelle verdrehsicher einbaubar ist.
+
+
+          0: Nein, die Messerwelle ist nicht verdrehsicher einbaubar. Sie kann um 180 Grad
+             versetzt wieder eingebaut werden. Nach dem Senken der Schneideinheit ist eine Referenzfahrt notwendig.
+          1: Ja, die Messerwelle ist verdrehsicher einbaubar.
+             Nach dem Senken der Schneideinheit ist keine Referenzfahrt notwendig.
+
+  blade_velocity_ratio:
+    name: "Geschwindigkeitsverh�ltnis Band-Messer [%]"
+    comment: |
+          Einstellm�glichkeit f�r das Veh�ltnis der Geschwindigkeiten zwischen Band und Messer.
+          Angabe wird als Prozent interpretiert, um die sich das Messer beim Schneiden schneller drehen
+          soll als das Band.
+          Werte kleiner 30 werden ignoriert.
+          Nach oben wird sichergestellt, das die maximale Messergeschwindigkeit nicht �berschritten wird.
+
+
+          Beispiel: Ein Wert von 30 bedeutet, dass sich das Messer 30 Prozent schneller dreht als das Band.
+          Bei einem ausreichend gro�em Wert - z.B. 2000 - w�rde sich das Messer immer mit maximaler Geschwindigkeit drehen.
+
+
+          Standard: 30.
+
+  sheet_retraction:
+    name: "Folienr�ckzug"
+    comment: |
+          Soll die Folie nach dem Schneiden zur�ckgezogen werden?
+
+
+          0: Nein, die Folie wird nach dem Schneiden nicht zur�ckgezogen.
+             H�here Leistung, h�here Papierstaugefahr.
+          1: Ja, die Folie wird nach dem Schneiden zur�ckgezogen.
+             Geringere Leistung, geringere Papierstaugefahr.
+
+  paper_feed_continuous_motion:
+    name: "St�ndige Bewegung des Blattantriebes"
+    comment: |
+          Soll der Blattantrieb sich st�ndig drehen?
+
+          0: Nein, der Blattantrieb bewegt sich nur w�hrend der Phase der Blattf�rderung.
+             Kommt keine Portion, bewegt sich der Blattantrieb nicht.
+          1: Ja, der Blattantrieb bewegt sich st�ndig, d.h. sobald sich das Band bewegt, bewegt sich auch der Blattantrieb.
+
+  paper_feed_velocity_ratio:
+    name: "Geschwindigkeitsverh�ltnis Band-Blattantrieb [%]"
+    comment: |
+          Einstellm�glichkeit f�r das Veh�ltnis der Geschwindigkeiten zwischen Band und Blattantrieb.
+          Angabe wird als Prozent interpretiert, um die sich der Blattantreib schneller drehen
+          soll als das Band.
+          G�ltige Werte liegen zwischen 0 und 30.
+
+
+          Beispiel: Ein Wert von 30 bedeutet, dass sich der Blattantrieb 30 Prozent schneller dreht als das Band.
+
+  role_diameter_teached_maximum:
+    name: "Gr��ter geteachter Rollendurchmesser [mm]"
+    comment: |
+          Konfiguration f�r die Erkennung des Rollendurchmessers.
+
+          Dieser Wert gibt den gr��ten Rollendurchmesser an, der beim Einrichten der Ultraschallsensoren verwendet wurde.
+          Die Angabe des Wertes erfolgt in Millimeter.
+
+
+          Achtung: Dieser Wert begrenzt die Erkennung der Rollendurchmesser - gr��ere Rollendurchmesser k�nnen nicht erkannt werden.
+
+  role_diameter_teached_minimum:
+    name: "Kleinster geteachter Rollendurchmesser [mm]"
+    comment: |
+          Konfiguration f�r die Erkennung des Rollendurchmessers.
+
+          Dieser Wert gibt den kleinsten Rollendurchmesser an, der beim Einrichten der Ultraschallsensoren verwendet wurde.
+          Die Angabe des Wertes erfolgt in Millimeter.
+
+
+          Achtung: Dieser Wert begrenzt die Erkennung der Rollendurchmesser - kleinere Rollendurchmesser k�nnen nicht erkannt werden.
+
+  role_diameter_message_level:
+    name: "Rollenendemeldung"
+    comment: |
+          Konfiguration f�r die Erkennung des Rollenendes.
+          Hiermit kann die Anzeige der Rolleendemeldung eingeschaltet werden.
+
+
+          Einerstelle: 'Meldung anzeigen'
+          x0: Es soll keine Meldung beim Erreichen des Rollenendes angezeigt werden.
+
+          x1: Warnung: Es soll eine Meldung bei Erreichen des Rollenendes angezeigt werden.
+              Es wird eine quittierbare Meldung angezeigt, die Maschine l�uft jedoch weiter.
+
+          x2: Fehler: Es soll eine Meldung bei Erreichen des Rollenendes angezeigt werden.
+              Es wird eine quittierbare Meldung angezeigt, die Maschine stoppt sofort.
+
+
+          Zehnerstelle: 'Freigabe vorgelagerte Einheit'
+          0x: Die Freigabe an die vorgelagerte Einheit wird nicht beeinflu�t.
+          1x: Die Freigabe an die vorgelagerte Einheit wird im Meldungsfall weggenommen.
+              Diese Einstellung wird nur wirksam in Kombination mit dem Wert '1' an der Einerstelle.
+
+  role_diameter_limit:
+    name: "Grenze f�r Rollenendemeldung [mm]"
+    comment: |
+          Konfiguration f�r die Erkennung des Rollenendes.
+
+
+          Dieser Wert gibt den Rollendurchmesser an, ab dem ein Rollenende gemeldet werden soll.
+          Die Angabe erfolgt in Millimeter.
+
   paper_roll_drive_selection:
     name:  "Bahnantrieb abgew�hlt=0/Servo=1/FU=2"
     comment: &COMMON_DRIVE_CONFIG | 
@@ -264,7 +408,7 @@ de:
     comment:  *COMMON_GEAR_OUT
 
   transport_drive_belt_length:
-    name:  "Portionsauflageband Bandl�nge"
+    name:  "Portionsauflageband Bandl�nge [mm]"
     comment:  "Gesamte Bandl�nge des Portionsauflagebandes.\nAngabe erfolgt in Millimeter."
 
   infeed_drive_selection:
@@ -284,7 +428,7 @@ de:
     comment:  *COMMON_GEAR_OUT
 
   infeed_drive_belt_length:
-    name:  "Einlegeband Bandl�nge"
+    name:  "Einlegeband Bandl�nge [mm]"
     comment:  | 
               Gesamte Bandl�nge des Einlegebandes.
               Angabe erfolgt in Millimeter.

data/examples/underleaver/underleaver.setup.param.en.yml

@@ -7,6 +7,9 @@ en:
   drives:
     name: "Drives Underleaver"
 
+  role_configuration:
+    name: "Role Detection"
+
   #parameter
   underleaver_config:
     name:  "Underleaver virtual=1 / real=0"
@@ -22,31 +25,31 @@ en:
               1xx: The controller simulates all drives."
 
   distance_photo_sensor:
-    name:  "Distance of photo sensor to paper exit"
+    name:  "Distance of photo sensor to paper exit [mm]"
     comment:  "Configuration of photo sensor.\n
               \n
                 X: Describes the distance [mm] from photo sensor to the paper exit."
 
   distance_photo_sensor_from_start:
-    name:   "Distance of photo sensor from start"
+    name:   "Distance of photo sensor from start [mm]"
     comment:  "Configuration of photo sensor.\n
               \n
                 X: Describes the distance [mm] to photo sensor from start of transport conveyor."
 
   distance_blade_to_sheet_drive:
-    name:  "Distance of blade"
+    name:  "Distance of blade [mm]"
     comment:  "Configuration of Blade\n
                \n
               X: Describes the distance [mm] from blade to the paper feed drive."
 
   distance_sheet_drive_to_sheet_exit:
-    name:  "Distance of sheet drive"
+    name:  "Distance of sheet drive [mm]"
     comment:  "Configuration of foil drive\n
               \n
               X: Describes the distance [mm] from the paper feed drive to paper exit."
 
   time_for_cutting_unit:
-    name:  "Time of cutting unit"
+    name:  "Time of cutting unit [ms]"
     comment:  "Configuration of cutting unit.\n
               \n
                X: Describes the time [ms] to lift up the cutting unit."
@@ -59,7 +62,7 @@ en:
               1: Select the paper jam monitoring."
 
   paper_jam_detection_signal_length:
-    name:  "Paper jam signal duration"
+    name:  "Paper jam signal duration [ms]"
     comment:  "Configuration of paper jam sensor\n
               \n
               X: Describes the signal duration [ms] that defines a paper jam.\n
@@ -68,7 +71,7 @@ en:
               Value is given in milliseconds."
 
   paper_jam_detection_check_time:
-    name:  "Paper jam check time after 'last' product"
+    name:  "Paper jam check time after 'last' product [ms]"
     comment:  "Configuration of paper jam sensor\n
               \n
               Paper jam checks for the current product are executed at the beginning of the next product.\n
@@ -96,7 +99,7 @@ en:
               2: Positiv continuously signal - enables by 12V"
 
   ext_enabling_following_unit_delay:
-    name:  "Configuration of enable delay"
+    name:  "Configuration of enable delay [ms]"
     comment:  "Configuration of external behavior (downstream)\n
               \n
               X: Describes the time [ms] to wait for reacting to the enabling signal. Not till then the underleaver continuous conveyance."
@@ -109,6 +112,20 @@ en:
               1: Negative continuously signal - enables by 0V\n
               2: Positiv continuously signal - enables by 12V"
 
+  config_safety_circuit:
+    name: "Configuration of safety circuit"
+    comment: |
+              Configures elements of the safety circuit of the machine.
+
+
+              Configuration of input Emergency-stop
+              0: not configured
+              1: Emergency-stop is installed, Low-Signal means Emergency-stop is pressed
+              2: Emergency-stop is installed, High-Signal means Emergency-stop is pressed
+              3: Input is interpreted as ready signal of main supply - Low-Signal means supply is not ready
+              4: Input is interpreted as ready signal of main supply - High-Signal means supply is not ready
+
+
   source_parameter_working_velocity:
     name:     "Parametersource for conveyor velocity"
     comment:  |
@@ -138,7 +155,7 @@ en:
 
   
   factor_activation_point_roll_bracket:
-    name:   "Factor activation point rollbracket"
+    name:   "Factor activation point rollbracket [%]"
     comment: |
              Factor for activation point of roll brake.
              
@@ -169,6 +186,131 @@ en:
 
           Value is given in millimeter.
 
+  dancer_pressure_algorithm:
+    name: "Algorithm for pressure calculation of dancer"
+    comment: |
+          This parameter configures the algorithm used for pressure calculation of dancer.
+          The dancer will be moved down with the calculated pressure.
+          These values are possible:
+
+
+          0: Linear equation
+          1: Quadratic equation
+          2: Polynomial of 5th degree
+
+          
+          Besides the used algorithm the values for lower and upper loop position and maximum pressure of
+          pressure regulator influence dancer motion.
+
+  blade_rotate_proof_installable:
+    name: "Blade rotate-proof installable"
+    comment: |
+          Is the blade rotate-proof installabel?
+
+
+          0: No, blade is not rotate-proof installable. It can be installed with a rotation of 180 degree.
+             After lowering the cutting unit the drives need to find their reference positions.
+          1: Yes, blade is rotate-proof installable.
+             After lowering the cutting unit the drives does not need to find their reference positions.
+
+  blade_velocity_ratio:
+    name: "Velocity Ratio conveyor vs. blade [%]"
+    comment: |
+          This parameter configures the velocity ratio between conveyor and blade.
+          Value is given in percent.
+          Value determines how much faster blade rotates during cut.
+          Values smaller than 30 will be ignored.
+          The maximum blade velocity is always respected.
+
+
+          Example: If value is 30, blade's velocity during cut is 30 percent higher than conveyor's velocity.
+          In order to let the blade cut with maximum velocity a large value - like 2000 - is needed.
+
+
+          Default: 30.
+
+  sheet_retraction:
+    name: "Sheet Retraction"
+    comment: |
+          Retraction of sheet after cut?
+
+
+          0: No, sheet will not be retracted after cut.
+             Better performance, higher chances of paper jams.
+          1: Yes, sheet will be retracted after cut.
+             Lower performance, lower chances of paper jams.
+
+  paper_feed_continuous_motion:
+    name: "Continuous Motion of paper feed"
+    comment: |
+          This parameters determines whether paper feed drive will continuously move or just during a sheet transport.
+
+          0: No, paper feed will only move during sheet transport.
+             If there is no product then paper feed will not move.
+          1: Yes, paper feed continuously moves. If coneyor moves then paper feed will also move.
+
+  paper_feed_velocity_ratio:
+    name: "Velocity Ratio conveyor vs. paper feed [%]"
+    comment: |
+          This parameter configures the velocity ratio between conveyor and paper feed.
+          Value is given in percent.
+          Value determines how much faster paper feed runs.
+          Values between 0 and 30 are valid.
+
+  role_diameter_teached_maximum:
+    name: "Maximum teached Role Diameter [mm]"
+    comment: |
+          Configuration of role diameter detection.
+
+
+          This value indicates the largest role diameter, which was used when configuring the ultrasonic sensors.
+          The value is given in millimeters.
+
+
+          Note: This value limits the detection of the role diameter - diameter greater than this value can not be detected.
+
+
+  role_diameter_teached_minimum:
+    name: "Minimum teached Role Diameter [mm]"
+    comment: |
+          Configuration of role diameter detection.
+
+          This value is the smallest role diameter, which was used when configuring the ultrasonic sensors. 
+          The value is given in millimeters.
+
+          Note: This value limits the detection of the role diameter - diameter smaller than this value can not be detected.
+
+  role_diameter_message_level:
+    name: "Role End Message"
+    comment: |
+          Configuration of role end detection.
+          Displaying a message atth end of the role can be switched on.
+
+
+          Unit�s Place: 'Display Message Level'
+          x0: There is no message to be displayed when reaching the role end .
+
+          x1: Warning: There will be a message displayed when reaching the role end.
+              You receive a message, the machine continues to run.
+
+          x2: Error: There will be a message displayed when reaching the role end.
+              You receive a message, the machine stops immediately.
+
+
+          Ten's Place: 'Enable previous unit'
+          0x: Enable to previous unit will not be manipulated.
+          1x: When reaching role end enable to previous unit is disabled.
+              This setting works only with value '1' at unit's place.
+
+  role_diameter_limit:
+    name: "Limit for Role End Message [mm]"
+    comment: |
+          Configuration of role end detection.
+
+
+          This value specifies the role diameter which triggers a role end message.
+          The value is given in millimeters.
+
   paper_roll_drive_selection:
     name:  "Paper roll drive - Select/Deselect"
     comment: &COMMON_DRIVE_CONFIG "Unit�s Place: 'Select/Deselect drive'\n

data/lib/setup_configuration/core_ext/array/grouping.rb

@@ -0,0 +1,40 @@
+require 'enumerator'
+
+class Array #:nodoc:
+
+  # Splits or iterates over the array in groups of size +number+,
+  # padding any remaining slots with +fill_with+ unless it is +false+.
+  #
+  #   %w(1 2 3 4 5 6 7).in_groups_of(3) {|group| p group}
+  #   ["1", "2", "3"]
+  #   ["4", "5", "6"]
+  #   ["7", nil, nil]
+  #
+  #   %w(1 2 3).in_groups_of(2, ' ') {|group| p group}
+  #   ["1", "2"]
+  #   ["3", " "]
+  #
+  #   %w(1 2 3).in_groups_of(2, false) {|group| p group}
+  #   ["1", "2"]
+  #   ["3"]
+  def in_groups_of(number, fill_with = nil)
+    if fill_with == false
+      collection = self
+    else
+      # size % number gives how many extra we have;
+      # subtracting from number gives how many to add;
+      # modulo number ensures we don't add group of just fill.
+      padding = (number - size % number) % number
+      collection = dup.concat([fill_with] * padding)
+    end
+
+    if block_given?
+      collection.each_slice(number) { |slice| yield(slice) }
+    else
+      groups = []
+      collection.each_slice(number) { |group| groups << group }
+      groups
+    end
+  end
+
+end

data/lib/setup_configuration/core_ext/array.rb

@@ -0,0 +1 @@
+require 'setup_configuration/core_ext/array/grouping'

data/lib/setup_configuration/core_ext.rb

@@ -0,0 +1,5 @@
+filenames = Dir["#{File.dirname(__FILE__)}/core_ext/*.rb"].sort.map do |path|
+  File.basename(path, '.rb')
+end
+
+filenames.each { |filename| require "setup_configuration/core_ext/#{filename}" }

data/lib/setup_configuration/legacy/importer.rb

@@ -1,4 +1,4 @@
-
+# encoding: utf-8
 module SetupConfiguration
 
   module Legacy