| <!DOCTYPE html> |
| |
| |
| |
| |
| |
| |
| |
| is a PLAIN-ENGLISH EXPLANATION for you. |
| - Everything inside <pre class="code"> ... </pre> is the ACTUAL CODE. |
| - The yellow boxes are IMPORTANT NOTES. |
| - The green boxes are "what this does in plain English". |
|
|
| WHERE THIS CODE LIVES IN THE ORIGINAL FILE: |
| Original file: notes.txt |
| Lines: 1 — 186 |
|
|
| ================================================================================ |
| --> |
| <html> |
| <head> |
| <meta charset="UTF-8"> |
| <title>01 — Config Variables | Siemens Configurator</title> |
| <style> |
| body { font-family: Arial, sans-serif; background: #f5f5f5; color: #222; margin: 20px; } |
| h1 { color: #003366; border-bottom: 3px solid #003366; padding-bottom: 6px; } |
| h2 { color: #005599; margin-top: 30px; } |
| h3 { color: #007733; } |
| pre.code { background: #1e1e1e; color: #d4d4d4; padding: 16px; border-radius: 6px; |
| font-family: Consolas, monospace; font-size: 13px; overflow-x: auto; |
| border-left: 4px solid #569cd6; white-space: pre-wrap; } |
| .comment { color: #6a9955; } |
| .keyword { color: #569cd6; } |
| .string { color: #ce9178; } |
| .number { color: #b5cea8; } |
| .note { background: #fff8dc; border: 2px solid #f0c040; border-radius: 6px; |
| padding: 12px; margin: 10px 0; } |
| .explain { background: #e8f5e9; border: 2px solid #4caf50; border-radius: 6px; |
| padding: 12px; margin: 10px 0; } |
| .warn { background: #fff3e0; border: 2px solid #ff9800; border-radius: 6px; |
| padding: 12px; margin: 10px 0; } |
| nav { background: #003366; padding: 10px; border-radius: 6px; } |
| nav a { color: #fff; text-decoration: none; margin-right: 18px; font-size: 14px; } |
| nav a:hover { text-decoration: underline; } |
| table { border-collapse: collapse; width: 100%; margin: 10px 0; } |
| th { background: #003366; color: white; padding: 8px; } |
| td { border: 1px solid #ccc; padding: 7px; vertical-align: top; } |
| tr:nth-child(even) td { background: #f0f0f0; } |
| </style> |
| </head> |
| <body> |
|
|
| <nav> |
| <a href="index.html">📋 README</a> |
| <a href="01_config_variables.html">① Config</a> |
| <a href="02_utility_functions.html">② Utilities</a> |
| <a href="03_drive_configuration.html">③ Drive Config</a> |
| <a href="04_ui_html_builder.html">④ HTML Builder</a> |
| <a href="05_event_handlers.html">⑤ Event Handlers</a> |
| <a href="06_machine_data.html">⑥ Machine Data</a> |
| </nav> |
|
|
| <h1>① Global Configuration Variables</h1> |
| <p> |
| This is the <strong>first section</strong> of the script. It runs once when the script starts. |
| Think of it as the <em>"settings file"</em> — everything that controls how the script behaves |
| is set here. A commissioning engineer or developer would change values here to adapt the |
| script to a different machine. |
| </p> |
| <p> |
| In VBScript, lines beginning with a single quote <code>'</code> are <em>comments</em> — they |
| are ignored by the computer and only exist to explain the code. |
| </p> |
|
|
| |
| |
| |
| |
| <h2>Section 1 — Version & Mode Flags</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Sets the script version number and controls |
| whether the Unwind/Rewind drives use <em>Servo mode</em> or <em>Vector mode</em>. |
| This version code (<code>S53b</code>) also appears in the on-screen title bar. |
| </div> |
|
|
| <pre class="code"><span class="keyword">If True Then</span> <span class="comment">' This "If True" block is just used to group the variable definitions together. |
| ' It always runs — it's not a real condition.</span> |
|
|
| ConfigVersion=<span class="string">"S53b"</span> <span class="comment">' Version string shown in the HTML title. Change this if you update the script.</span> |
| <span class="comment">' History: S48=Nov2023, S49=Feb2024, S50=Apr2024, S51-S53=mid-2024</span> |
|
|
| <span class="comment">' S48 Revision - Part 'a' - Nov 2023 - Revised for vector mode support</span> |
| VectorMode=<span class="keyword">True</span> <span class="comment">' True = the script includes vector-mode drive support (for winders)</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 2 — Machine Type & PLC Type</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Selects which type of machine this script is configured for. |
| Machine type affects how the <strong>Emergency Stop (E-stop)</strong> is handled. |
| PLC type affects the bit-width used for speed feedback signals. |
| </div> |
|
|
| <table> |
| <tr><th>Variable</th><th>Value</th><th>Meaning</th></tr> |
| <tr><td><code>ConfigMachineType</code></td><td>1</td><td>K5 Standard — instantaneous E-stop</td></tr> |
| <tr><td><code>ConfigMachineType</code></td><td>2</td><td>K5 Vision & Expert — timed E-stop</td></tr> |
| <tr><td><code>ConfigMachineType</code></td><td>3</td><td>Selectable — engineer picks from UI dropdown</td></tr> |
| <tr><td><code>ConfigMachinePlcType</code></td><td>1</td><td>S7 Classic — 16-bit speed feedback</td></tr> |
| <tr><td><code>ConfigMachinePlcType</code></td><td>2</td><td>TIA Portal — 32-bit speed feedback</td></tr> |
| <tr><td><code>ConfigMachinePlcType</code></td><td>3</td><td>Selectable — engineer picks from UI dropdown</td></tr> |
| </table> |
|
|
| <pre class="code"> ConfigMachineType=<span class="number">3</span> <span class="comment">' ← CHANGE THIS to 1, 2, or 3 to hard-code the machine type |
| ' or leave as 3 to let the engineer choose in the UI</span> |
| ConfigMachinePlcType=<span class="number">3</span> <span class="comment">' ← CHANGE THIS to 1 or 2 to hard-code PLC type |
| ' or leave as 3 to let the engineer choose in the UI</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 3 — Option Flags</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Toggles optional features on or off. |
| </div> |
|
|
| <pre class="code"> ConfigOption01_SetupComms=<span class="keyword">True</span> <span class="comment">' True = automatically configure communications telegram on the CU320 |
| ' False = skip comms setup (useful if comms is pre-configured)</span> |
|
|
| TelegramIsConfigured=<span class="keyword">False</span> <span class="comment">' Internal tracking flag. Set to False at start. |
| ' Set to True by SetupComms() after it runs. |
| ' Used in UpdateStatusDisplay to show "Complete" on step 3.</span> |
|
|
| ConfigOption02_Logfile=<span class="keyword">True</span> <span class="comment">' True = write a log script in Starter showing every parameter changed |
| ' The log is stored as a script called "LogFile" in the Starter project. |
| ' Very useful for auditing what the script changed.</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 4 — Winder Drive Type</h2> |
|
|
| <pre class="code"> ConfigWinderDriveType=<span class="number">3</span> |
| <span class="comment">' 1 = Servo mode — high-precision position/speed control (default for winders) |
| ' 2 = Vector mode — torque-focused control (used for larger winder motors) |
| ' 3 = Selectable — engineer picks in the UI at commissioning time |
| ' |
| ' NOTE: Changing winder type requires a factory reset of the Unwind and Rewind drives. |
| ' The gains also change: Vector = Kp 5 / Ti 200ms, Servo = Kp 90 / Ti 50ms</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 5 — Logging / Debug Options</h2> |
|
|
| <pre class="code"> APP.LogActive = <span class="keyword">True</span> <span class="comment">' Enable Starter's internal application log</span> |
| APP.LogMode=<span class="string">"1"</span> <span class="comment">' Log mode 1 = errors only</span> |
| On Error GoTo 0 <span class="comment">' If there is a script error, stop and show the error to the user</span> |
| Set ThisProject=PROJ <span class="comment">' PROJ is the current open Starter project. We store a reference to it here.</span> |
|
|
| ParameterEchoToScreen=<span class="keyword">False</span> <span class="comment">' True = print every parameter write to the HTML status bar (very noisy, for debug only)</span> |
| CompressedCSVLogfile=<span class="keyword">False</span> <span class="comment">' True = remove spacing from log file (compact CSV format) |
| ' False = padded columns for easy reading</span> |
| LogfilePadLength=<span class="number">15</span> <span class="comment">' If CompressedCSVLogfile=False, each column in the log file is padded to 15 characters wide</span> |
| ExtendedDiag = <span class="keyword">True</span> <span class="comment">' True = print extra diagnostic messages to the HTML status bar during configuration</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 6 — Drive Count & Drive List</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Defines how many drives the script knows about |
| and assigns each one a name, a flag for whether it is a "line drive" (follows web speed), |
| and a communications slot number on the CU320. |
| </div> |
|
|
| <div class="note"> |
| <strong>🔑 Key Rule:</strong> The <code>DriveList</code> names MUST exactly match |
| the Technology Object (TO) names inside the Starter project after the Identify Drives step. |
| If they don't match, the script cannot configure that drive. |
| </div> |
|
|
| <pre class="code"> NumDrives=<span class="number">13</span> <span class="comment">' Total number of drives in this project (changed from 8 → 12 → 13 over revisions) |
| ' If you add a new drive, increment this and add a DriveList entry below.</span> |
|
|
| NumIdentList=<span class="number">16</span> <span class="comment">' Maximum rows in the Drive Identification table (allows up to 16 physical drives to appear)</span> |
|
|
| <span class="comment">' ── Drive List Definition ────────────────────────────────────────────────────────────────────── |
| ' Each drive gets 3 things assigned: |
| ' DriveList(n) = The name the drive must have in Starter (must match TO name) |
| ' LineDrive(n) = True → drive speed is proportional to line (web) speed |
| ' False → drive is a layarm (position-controlled, independent of line speed) |
| ' DriveCommSlot(n) = Which slot on the CU320 this drive uses for communications |
| ' (slots 1-10 are used; 0 = no comms needed) |
| ' ──────────────────────────────────────────────────────────────────────────────────────────────</span> |
|
|
| DriveList(<span class="number">1</span>)=<span class="string">"Unwind"</span> : LineDrive(<span class="number">1</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">1</span>)=<span class="number">3</span> <span class="comment">'CU1 drive 1 (Unwind = winder, follows line)</span> |
| DriveList(<span class="number">2</span>)=<span class="string">"Draw"</span> : LineDrive(<span class="number">2</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">2</span>)=<span class="number">7</span> <span class="comment">'CU2 drive 5 (Draw = pulls web)</span> |
| DriveList(<span class="number">3</span>)=<span class="string">"Drum"</span> : LineDrive(<span class="number">3</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">3</span>)=<span class="number">3</span> <span class="comment">'CU2 drive 1 (Drum = main tension drum)</span> |
| DriveList(<span class="number">4</span>)=<span class="string">"DTR1wcr"</span> : LineDrive(<span class="number">4</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">4</span>)=<span class="number">8</span> <span class="comment">'CU2 drive 6 (DTR1 = Draw Tension Roller 1)</span> |
| DriveList(<span class="number">5</span>)=<span class="string">"DTR2cork"</span> : LineDrive(<span class="number">5</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">5</span>)=<span class="number">6</span> <span class="comment">'CU2 drive 4 (DTR2 = Draw Tension Roller 2)</span> |
| DriveList(<span class="number">6</span>)=<span class="string">"Rewind"</span> : LineDrive(<span class="number">6</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">6</span>)=<span class="number">4</span> <span class="comment">'CU1 drive 2 (Rewind = winder, follows line)</span> |
| DriveList(<span class="number">7</span>)=<span class="string">"UnwindLayarm"</span> : LineDrive(<span class="number">7</span>)=<span class="keyword">False</span> : DriveCommSlot(<span class="number">7</span>)=<span class="number">4</span> <span class="comment">'CU2 drive 2 (Unwind Layarm = arm, NOT a line drive)</span> |
| DriveList(<span class="number">8</span>)=<span class="string">"RewindLayarm"</span> : LineDrive(<span class="number">8</span>)=<span class="keyword">False</span> : DriveCommSlot(<span class="number">8</span>)=<span class="number">5</span> <span class="comment">'CU2 drive 3 (Rewind Layarm = arm, NOT a line drive)</span> |
| DriveList(<span class="number">9</span>)=<span class="string">"Draw2"</span> : LineDrive(<span class="number">9</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">9</span>)=<span class="number">10</span> <span class="comment">'CU2 drive 8 (added for Atom machine)</span> |
| DriveList(<span class="number">10</span>)=<span class="string">"Draw3"</span> : LineDrive(<span class="number">10</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">10</span>)=<span class="number">4</span> <span class="comment">'CU3 drive 2</span> |
| DriveList(<span class="number">11</span>)=<span class="string">"Drum2"</span> : LineDrive(<span class="number">11</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">11</span>)=<span class="number">9</span> <span class="comment">'CU2 drive 7</span> |
| DriveList(<span class="number">12</span>)=<span class="string">"Drum3"</span> : LineDrive(<span class="number">12</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">12</span>)=<span class="number">3</span> <span class="comment">'CU3 drive 1</span> |
| DriveList(<span class="number">13</span>)=<span class="string">"Draw4"</span> : LineDrive(<span class="number">13</span>)=<span class="keyword">True</span> : DriveCommSlot(<span class="number">13</span>)=<span class="number">5</span> <span class="comment">'CU3 drive 3 (added for Barbaro machine extra drives)</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 7 — Setup Step List</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Defines the names of the 11 buttons shown |
| in the main HTML UI, in order from Step 0 to Step 10. |
| Each button triggers a specific action. |
| </div> |
|
|
| <pre class="code"> NumSteps=<span class="number">10</span> <span class="comment">' Number of steps (0 through 10) — changed from fewer steps in earlier revisions</span> |
|
|
| StepList(<span class="number">0</span>)=<span class="string">"Automatic Controller Reset"</span> <span class="comment">' Not a script step — reminder to run Starter's auto-reset</span> |
| StepList(<span class="number">1</span>)=<span class="string">"Identify Drives"</span> <span class="comment">' Shows drive table, lets engineer assign function names to drives</span> |
| StepList(<span class="number">2</span>)=<span class="string">"Edit Machine Data"</span> <span class="comment">' Shows machine data form (gear ratios, diameters etc.)</span> |
| StepList(<span class="number">3</span>)=<span class="string">"Config Infeed and CUs"</span> <span class="comment">' Runs ConfigureAllCUs() — sets up CU320 and infeed parameters</span> |
| StepList(<span class="number">4</span>)=<span class="string">"Config Drives"</span> <span class="comment">' Runs ConfigureAllDrives() — sets drive-specific parameters</span> |
| StepList(<span class="number">5</span>)=<span class="string">"Download"</span> <span class="comment">' Goes online and downloads all parameters to physical drives</span> |
| StepList(<span class="number">6</span>)=<span class="string">"Safety Integrated Setup"</span> <span class="comment">' Reminder step — engineer must do this manually in Starter</span> |
| StepList(<span class="number">7</span>)=<span class="string">"Motor Identification"</span> <span class="comment">' Reminder step — engineer must run motor ID routine manually</span> |
| StepList(<span class="number">8</span>)=<span class="string">"Post ID Drive Config"</span> <span class="comment">' Fixes parameters that motor ID overwrites (speed loop gains etc.)</span> |
| StepList(<span class="number">9</span>)=<span class="string">"Ram to Rom, Upload & Save"</span> <span class="comment">' Copies drive RAM → ROM, then uploads from drives back to Starter project</span> |
| StepList(<span class="number">10</span>)=<span class="string">"Export File to HMI"</span> <span class="comment">' (Added in S53) Saves machine data to a file for the HMI panel</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 8 — Non Drive-Cliq Motor List</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Registers known motor types that don't have |
| DriveCliq (Siemens' plug-and-play motor interface). The script cannot auto-detect these, |
| so they must be listed here. Add new motors here if needed. |
| </div> |
|
|
| <pre class="code"> NumSiemensMotorList=<span class="number">2</span> <span class="comment">' How many non-cliq motors are listed below (change if you add more)</span> |
|
|
| <span class="comment">' Format: Code = Siemens motor order code. Description = model number string.</span> |
| <span class="comment">' Ratings are shown in the comment for reference only — not used by the script.</span> |
| SiemensMotorList_Code(<span class="number">1</span>)=<span class="number">28643</span> : SiemensMotorList_Description(<span class="number">1</span>)=<span class="string">"1FW6150-0xx05-4Fxx"</span> <span class="comment">'Ratings: 360 Nm, 20.3 kW</span> |
| SiemensMotorList_Code(<span class="number">2</span>)=<span class="number">28661</span> : SiemensMotorList_Description(<span class="number">2</span>)=<span class="string">"1FW6160-xxx10-2Pxx"</span> <span class="comment">'Ratings: 933 Nm, 38.9 kW</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 9 — Machine Default Data Tables</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> Stores pre-defined gear ratio and roller diameter values |
| for known machine types (K5 Expert, K5 Vision, Barbaro, Master). |
| If <code>DefaultingMode=1</code>, these values are loaded automatically when the script runs |
| for the first time on a fresh project — saving the engineer from typing everything manually. |
| </div> |
|
|
| <div class="warn"> |
| <strong>⚠️ Note:</strong> <code>DefaultingMode</code> is currently set to <code>0</code> |
| (blank on first startup). Set it to <code>1</code> to use the tables below as defaults. |
| Change <code>MachineModel</code> to select which machine's data to use (0=Custom, 1=K5 Expert, |
| 2=K5 Vision, 3=Barbaro, 4=Master). |
| </div> |
|
|
| <pre class="code"> MachineModel = <span class="number">1</span> <span class="comment">' 0=Custom, 1=K5 Expert, 2=K5 Vision, 3=Barbaro, 4=Master</span> |
| DefaultingMode = <span class="number">0</span> <span class="comment">' 0=Blank on first startup, 1=Use table below on first startup</span> |
|
|
| <span class="comment">' Columns below correspond to drives: |
| ' UNW DRAW DRUM DTR1 DTR2 REW ULAY RLAY DRAW2 DRAW3 DRUM2 DRUM3 DRAW4 |
| ' [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13]</span> |
|
|
| MachineK5EGearData = Array( <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">2.857</span>, <span class="number">1.1</span>, <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">89.2</span>, <span class="number">41.43</span>, <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">2.857</span>, <span class="number">2.857</span>, <span class="number">1.0</span>) |
| MachineK5EDiamData = Array( <span class="number">165</span>, <span class="number">194</span>, <span class="number">700.0</span>, <span class="number">250</span>, <span class="number">326.2</span>, <span class="number">165</span>, <span class="number">81.49</span>, <span class="number">101.86</span>, <span class="number">197.4</span>, <span class="number">197.4</span>, <span class="number">900.0</span>, <span class="number">900.0</span>, <span class="number">197.4</span>) |
| <span class="comment">' ↑ K5 Expert defaults: Drum gear=2.857x, Layarms have high ratios (89x / 41x), etc.</span> |
|
|
| MachineK5vGearData = Array( <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">2.857</span>, <span class="number">1.1</span>, <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">89.2</span>, <span class="number">160.0</span>, <span class="number">1.0</span>, <span class="number">1.0</span>, <span class="number">2.857</span>, <span class="number">2.857</span>, <span class="number">1.0</span>) |
| MachineK5vDiamData = Array( <span class="number">165</span>, <span class="number">193.2</span>, <span class="number">700.0</span>, <span class="number">251.2</span>, <span class="number">184.2</span>, <span class="number">165</span>, <span class="number">81.49</span>, <span class="number">101.86</span>, <span class="number">197.4</span>, <span class="number">197.4</span>, <span class="number">900.0</span>, <span class="number">900.0</span>, <span class="number">197.4</span>) |
| <span class="comment">' ↑ K5 Vision: Rewind layarm gear ratio is 160 (different from Expert's 41.43)</span> |
| <span class="keyword">End If</span> <span class="comment">' End of the "If True" grouping block</span> |
| </pre> |
|
|
| |
| |
| |
| <h2>Section 10 — Main Script Startup Sequence</h2> |
|
|
| <div class="explain"> |
| <strong>What this does:</strong> After all variable definitions, these lines actually |
| <em>run the script</em> in order. Think of them as the "main function" of the program. |
| </div> |
|
|
| <pre class="code"><span class="comment">' ─────────────── START OF MAIN SCRIPT ───────────────</span> |
|
|
| CreateMainPage <span class="comment">' Opens an Internet Explorer (MSIE) window to host the HTML UI</span> |
| CreateMainPageDocument <span class="comment">' Writes all the HTML (buttons, tables, forms) into that window</span> |
| CheckMachineDataExists <span class="comment">' Checks if machine data was saved from a previous session and loads it</span> |
| CreateLogFile <span class="comment">' Creates a VBScript log file called "LogFile" inside Starter</span> |
| PrintToLogFile(<span class="string">"* Test log file ---- Date: "</span>&Date) <span class="comment">' Writes today's date as the first log entry</span> |
| UpdateStatusDisplay <span class="comment">' Refreshes which buttons are greyed out / active based on current state</span> |
| EventHandler(MainPage) <span class="comment">' Enters the event loop — waits indefinitely for the user to click buttons</span> |
|
|
| <span class="comment">' ─────────────── END OF MAIN SCRIPT ───────────────── |
| ' After EventHandler() returns (user closed the window), the script ends.</span> |
| </pre> |
|
|
| <hr> |
| <p style="color:#888; font-size:12px;"> |
| ← This file only covers lines 1–201 of the original notes.txt. |
| Continue to <a href="02_utility_functions.html">② Utility Functions</a>. |
| </p> |
|
|
| </body> |
| </html> |
|
|
