ILOGICS Product Documentation

User Tools

Site Tools

Trace: • temperature • irtcsetalarm2 • isegbrightness • pid • first_project • edge_scale • en-us_sidebar • irtcunixtime • mpa_x • analog_input
en-us_products:mpino_studio2:box_functions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en-us_products:mpino_studio2:box_functions [2026/09/09 23:20] – 바깥 편집 127.0.0.1en-us_products:mpino_studio2:box_functions [2026/09/12 18:08] (current) – 바깥 편집 127.0.0.1
Line 3: Line 3:
 This page explains how to enter and edit box functions, when they run, and which box functions MPINO Studio 2 provides. This page explains how to enter and edit box functions, when they run, and which box functions MPINO Studio 2 provides.
  
-{{ :en-us_products:mpino_studio2:box-function-learning-path.svg?1000 |This page explains how to enter and edit box functions, when they run, and which box functions MPINO Studio 2 provides. }}+{{ :en-us_products:mpino_studio2:box-function-learning-path.svg?1000 |Steps from creating a box function to checking its behavior }}
  
-===== 1. Box Function Editor =====+===== 1. Create a Box Function ===== 
 + 
 +==== How to Create a Command ==== 
 + 
 +  - Select a ladder cell and press ''Ctrl + Enter'' to create a box function. 
 +  - Choose a category and command in the editor. 
 +  - Enter the selected argument, then press ''Tab'' for the next argument. 
 +  - Press ''Enter'' or **OK** when the command is complete.
  
 The box function editor is where you find a command and complete its arguments. Each marker points to the item described below. The box function editor is where you find a command and complete its arguments. Each marker points to the item described below.
  
-{{ :en-us_products:mpino_studio2:box-function-editor-marked.svg?1000 |The box function editor is where you find a command and complete its arguments. Each marker points to the item described below. }}+{{ :en-us_products:mpino_studio2:box-function-editor-marked.svg?1000 |Category, command list, input field, help, and confirmation in the box function editor }}
  
   * **①** Category: Choose a command group such as Timer, Counter, or Arithmetic.   * **①** Category: Choose a command group such as Timer, Counter, or Arithmetic.
Line 17: Line 24:
   * **⑤** OK and Cancel: Save the input to the cell or discard the change.   * **⑤** OK and Cancel: Save the input to the cell or discard the change.
  
-===== 2. Choose and Enter a Command =====+==== How to Read a Command ====
  
 Choose a category and a command. The editor fills in the command template and selects its first argument. Enter a value and press ''Tab'' to move to the next argument. In structured commands, separate the command name and arguments with spaces. Choose a category and a command. The editor fills in the command template and selects its first argument. Enter a value and press ''Tab'' to move to the next argument. In structured commands, separate the command name and arguments with spaces.
  
-  - Select a ladder cell and press ''Ctrl + Enter'' to create a box function. +{{ :en-us_products:mpino_studio2:box-function-entry-anatomy.svg?1000 |How a command name and its arguments are entered }}
-  - Choose a category and command in the editor. +
-  - Enter the selected argument, then press ''Tab'' for the next argument. +
-  - Press ''Enter'' or **OK** when the command is complete. +
- +
-{{ :en-us_products:mpino_studio2:box-function-entry-anatomy.svg?1000 |Choose a category and a command. The editor fills in the command template and selects its first argument. Enter a value and press ''Tab'' to move to the next argument. In structured commands, separate the command name and arguments with spaces. }}+
  
-===== 3. Edit an Existing Command =====+===== 2. Edit an Existing Command =====
  
 To edit an existing box function, select its cell and press ''Enter'', or double-click it. Choosing another command replaces the entire input with that command's template. **OK** saves the change; **Cancel** restores the value from before editing. To edit an existing box function, select its cell and press ''Enter'', or double-click it. Choosing another command replaces the entire input with that command's template. **OK** saves the change; **Cancel** restores the value from before editing.
  
-===== 4. Box Function Execution Condition =====+===== 3. Box Function Execution Condition =====
  
 The ON or OFF state from the contacts on the left is the box function's input. Timers and counters process their current and done states by command even while the input is OFF. With no contact, the input is always ON. Use a positive-edge contact when a cumulative command such as ''INC D0'' should run once. The ON or OFF state from the contacts on the left is the box function's input. Timers and counters process their current and done states by command even while the input is OFF. With no contact, the input is always ON. Use a positive-edge contact when a cumulative command such as ''INC D0'' should run once.
  
-{{ :en-us_products:mpino_studio2:box-function-execution.svg?1000 |The ON or OFF state from the contacts on the left is the box function's input. Timers and counters process their current and done states by command even while the input is OFF. With no contact, the input is always ON. Use a positive-edge contact when a cumulative command such as ''INC D0'' should run once. }}+{{ :en-us_products:mpino_studio2:box-function-execution.svg?1000 |How the left contact controls box function execution }}
  
-===== 5. Structured and Free-form Input =====+===== 4. Structured and Free-form Input =====
  
 Structured commands are the 44 commands registered in the palette; each has a fixed syntax and argument count. Free-form input accepts an assignment containing an expression or an Arduino function call that you enter directly. Structured commands are the 44 commands registered in the palette; each has a fixed syntax and argument count. Free-form input accepts an assignment containing an expression or an Arduino function call that you enter directly.
Line 46: Line 48:
 | Free-form | ''D0 = readSensor()'' | Enter a supported expression or call a function written in Arduino code | | Free-form | ''D0 = readSensor()'' | Enter a supported expression or call a function written in Arduino code |
  
-===== 6. Calling an Arduino Code Function =====+===== 5. Call an Arduino Code Function =====
  
-A function written in Arduino Code can be called from a free-form box function.+The two screens below show the ''setMotor()'' function written in Arduino Code and a box function that calls the same function from ladder logic.
  
-^ Method ^ Box function input ^ Behavior ^ +==== Write the Function in Arduino Code ====
-| Function call | ''setMotor(100)'' | Runs the function without storing a return value. | +
-| Store return value | ''D0 = readSensor()'' | Stores the function return value in D0. |+
  
-The function name, letter case, argument count, and argument types must match its definition in Arduino Code. Separate multiple arguments with commas inside the parentheses, and do not add a semicolon at the end. Execution follows the **Box Function Execution Condition** above.+{{ :en-us_products:mpino_studio2:arduino-code-setmotor.svg?1000 |The setMotor() function written in Arduino Code }} 
 + 
 +==== Call the Function from Ladder Logic ==== 
 + 
 +{{ :en-us_products:mpino_studio2:ladder-arduino-call.svg?1000 |A box function that calls setMotor(100) when the M0 contact is ON }} 
 + 
 +The function name, letter case, argument count, and argument types in the box function must match the definition in Arduino Code. Do not add a semicolon at the end. In this example, ''setMotor(100)'' runs while the M0 contact is ON.
  
 [[en-us_products:mpino_studio2:box_functions:free_input|View Arduino Code function-call details]] [[en-us_products:mpino_studio2:box_functions:free_input|View Arduino Code function-call details]]
  
-===== 7. Box Function List =====+===== 6. Box Function List =====
  
 ^ Category ^ Command ^ Function ^ ^ Category ^ Command ^ Function ^
-| Timer Box Functions | [[en-us_products:mpino_studio2:box_functions:timer#ton|TON]] | Accumulates time while the input is ON and turns the done state ON at the set value. | +| Timer Box Functions | [[en-us_products:mpino_studio2:box_functions:timer:ton|TON]] | Accumulates time while the input is ON and turns the done state ON at the set value. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#toff|TOFF]] | Turns the done state ON immediately with the input. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:toff|TOFF]] | Turns the done state ON immediately with the input. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tpl|TPL]] | Turns the done state ON when the input changes to ON. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tpl|TPL]] | Turns the done state ON when the input changes to ON. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tmon|TMON]] | Starts one pulse when the input turns ON and holds the done state ON for the set time. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tmon|TMON]] | Starts one pulse when the input turns ON and holds the done state ON for the set time. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tmr|TMR]] | Accumulates time while the input is ON. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tmr|TMR]] | Accumulates time while the input is ON. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#taon|TAON]] | Provides the same on-delay behavior as TON with a 100 ms tick. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:taon|TAON]] | Provides the same on-delay behavior as TON with a 100 ms tick. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#taoff|TAOFF]] | Provides the same off-delay behavior as TOFF with a 100 ms tick. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:taoff|TAOFF]] | Provides the same off-delay behavior as TOFF with a 100 ms tick. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tapl|TAPL]] | Provides the same input-held pulse behavior as TPL with a 100 ms tick. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tapl|TAPL]] | Provides the same input-held pulse behavior as TPL with a 100 ms tick. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tamon|TAMON]] | Provides the same one-shot pulse behavior as TMON with a 100 ms tick. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tamon|TAMON]] | Provides the same one-shot pulse behavior as TMON with a 100 ms tick. | 
-|  | [[en-us_products:mpino_studio2:box_functions:timer#tamr|TAMR]] | Provides the same retentive behavior as TMR with a 100 ms tick. | +|  | [[en-us_products:mpino_studio2:box_functions:timer:tamr|TAMR]] | Provides the same retentive behavior as TMR with a 100 ms tick. | 
-| Counter Box Functions | [[en-us_products:mpino_studio2:box_functions:counter#2_ctu|CTU]] | Increments the current value once whenever the left condition changes from OFF to ON. | +| Counter Box Functions | [[en-us_products:mpino_studio2:box_functions:counter:ctu|CTU]] | Increments the current value once whenever the left condition changes from OFF to ON. | 
-|  | [[en-us_products:mpino_studio2:box_functions:counter#3_ctd|CTD]] | Preloads the current value with the set value, then decrements it once on each rising edge of the left condition. | +|  | [[en-us_products:mpino_studio2:box_functions:counter:ctd|CTD]] | Preloads the current value with the set value, then decrements it once on each rising edge of the left condition. | 
-|  | [[en-us_products:mpino_studio2:box_functions:counter#4_ctud|CTUD]] | While the left condition is ON, a rising edge on the up input adds one and a rising edge on the down input subtracts one. | +|  | [[en-us_products:mpino_studio2:box_functions:counter:ctud|CTUD]] | While the left condition is ON, a rising edge on the up input adds one and a rising edge on the down input subtracts one. | 
-| Bit and Latch Box Functions | [[en-us_products:mpino_studio2:box_functions:bit_latch#set|SET]] | When the left condition is ON, stores ON in an M bit or a P bit configured as an output and holds it after the condition turns OFF. | +| Bit and Latch Box Functions | [[en-us_products:mpino_studio2:box_functions:bit_latch:set|SET]] | When the left condition is ON, stores ON in an M bit or a P bit configured as an output and holds it after the condition turns OFF. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_latch#rst|RST]] | When the left condition is ON, stores OFF in an M bit or a P bit configured as an output. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_latch:rst|RST]] | When the left condition is ON, stores OFF in an M bit or a P bit configured as an output. | 
-| Arithmetic Box Functions | [[en-us_products:mpino_studio2:box_functions:arithmetic#add|ADD]] | Adds two values and stores the result in the destination. | +| Arithmetic Box Functions | [[en-us_products:mpino_studio2:box_functions:arithmetic:add|ADD]] | Adds two values and stores the result in the destination. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#sub|SUB]] | Subtracts the second value from the first and stores the result in the destination. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:sub|SUB]] | Subtracts the second value from the first and stores the result in the destination. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#mul|MUL]] | Multiplies two values and stores the result in the destination. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:mul|MUL]] | Multiplies two values and stores the result in the destination. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#div|DIV]] | Divides the first value by the second and stores the quotient. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:div|DIV]] | Divides the first value by the second and stores the quotient. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#mod|MOD]] | Divides the first value by the second and stores the remainder. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:mod|MOD]] | Divides the first value by the second and stores the remainder. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#inc|INC]] | Increments the destination by one and stores it back at the same address. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:inc|INC]] | Increments the destination by one and stores it back at the same address. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#dec|DEC]] | Decrements the destination by one and stores it back at the same address. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:dec|DEC]] | Decrements the destination by one and stores it back at the same address. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#4_scale|SCALE]] | Linearly maps an integer from an input range to an integer output range. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:scale|SCALE]] | Linearly maps an integer from an input range to an integer output range. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#floor|FLOOR]] | Stores the greatest integer that is not larger than the source. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:floor|FLOOR]] | Stores the greatest integer that is not larger than the source. | 
-|  | [[en-us_products:mpino_studio2:box_functions:arithmetic#sqrt|SQRT]] | Stores the square root of the source. | +|  | [[en-us_products:mpino_studio2:box_functions:arithmetic:sqrt|SQRT]] | Stores the square root of the source. | 
-| Transfer Box Functions | [[en-us_products:mpino_studio2:box_functions:transfer#2_mov|MOV]] | Copies one source value to the destination. | +| Transfer Box Functions | [[en-us_products:mpino_studio2:box_functions:transfer:mov|MOV]] | Copies one source value to the destination. | 
-|  | [[en-us_products:mpino_studio2:box_functions:transfer#3_gmov|GMOV]] | Copies a contiguous range of D, C, or T WORD values to a destination range in the same order. | +|  | [[en-us_products:mpino_studio2:box_functions:transfer:gmov|GMOV]] | Copies a contiguous range of D, C, or T WORD values to a destination range in the same order. | 
-|  | [[en-us_products:mpino_studio2:box_functions:transfer#4_fmov|FMOV]] | Reads one D, C, or T WORD address and fills a contiguous destination WORD range with that value. | +|  | [[en-us_products:mpino_studio2:box_functions:transfer:fmov|FMOV]] | Reads one D, C, or T WORD address and fills a contiguous destination WORD range with that value. | 
-| Bitwise Operation Box Functions | [[en-us_products:mpino_studio2:box_functions:bit_operations#wand|WAND]] | Applies bitwise AND to two WORD values and stores the result. | +| Bitwise Operation Box Functions | [[en-us_products:mpino_studio2:box_functions:bit_operations:wand|WAND]] | Applies bitwise AND to two WORD values and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#wor|WOR]] | Applies bitwise OR to two WORD values and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:wor|WOR]] | Applies bitwise OR to two WORD values and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#wxor|WXOR]] | Applies bitwise XOR to two WORD values and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:wxor|WXOR]] | Applies bitwise XOR to two WORD values and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#3_wnot|WNOT]] | Inverts every bit in the source WORD and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:wnot|WNOT]] | Inverts every bit in the source WORD and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#shl|SHL]] | Shifts a WORD left and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:shl|SHL]] | Shifts a WORD left and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#shr|SHR]] | Logically shifts a D WORD right and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:shr|SHR]] | Logically shifts a D WORD right and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#rol|ROL]] | Rotates a D, C, or T WORD left. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:rol|ROL]] | Rotates a D, C, or T WORD left. | 
-|  | [[en-us_products:mpino_studio2:box_functions:bit_operations#ror|ROR]] | Rotates a D, C, or T WORD right. | +|  | [[en-us_products:mpino_studio2:box_functions:bit_operations:ror|ROR]] | Rotates a D, C, or T WORD right. | 
-| Conversion Box Functions | [[en-us_products:mpino_studio2:box_functions:conversion#inv|INV]] | Inverts every bit in the source WORD and stores the result. | +| Conversion Box Functions | [[en-us_products:mpino_studio2:box_functions:conversion:inv|INV]] | Inverts every bit in the source WORD and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:conversion#neg|NEG]] | Reverses the sign of the source value and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:conversion:neg|NEG]] | Reverses the sign of the source value and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:conversion#h2d|H2D]] | Interprets a source WORD containing four BCD digits as a decimal integer and stores the result. | +|  | [[en-us_products:mpino_studio2:box_functions:conversion:h2d|H2D]] | Interprets a source WORD containing four BCD digits as a decimal integer and stores the result. | 
-|  | [[en-us_products:mpino_studio2:box_functions:conversion#d2h|D2H]] | Converts a decimal integer from 0 to 9999 into four-digit BCD and stores it in a WORD. | +|  | [[en-us_products:mpino_studio2:box_functions:conversion:d2h|D2H]] | Converts a decimal integer from 0 to 9999 into four-digit BCD and stores it in a WORD. | 
-| Logic Control Box Functions | [[en-us_products:mpino_studio2:box_functions:logic_control#jmp|JMP]] | When the left condition is ON, moves to a later label in the same ladder and skips the ladder rows between. | +| Logic Control Box Functions | [[en-us_products:mpino_studio2:box_functions:logic_control:jmp|JMP]] | When the left condition is ON, moves to a later label in the same ladder and skips the ladder rows between. | 
-|  | [[en-us_products:mpino_studio2:box_functions:logic_control#jmpn|JMPN]] | When the left condition is OFF, moves to a later label in the same ladder. | +|  | [[en-us_products:mpino_studio2:box_functions:logic_control:jmpn|JMPN]] | When the left condition is OFF, moves to a later label in the same ladder. | 
-|  | [[en-us_products:mpino_studio2:box_functions:logic_control#mcs|MCS]] | Starts a master control zone at a level from 0 to 15. | +|  | [[en-us_products:mpino_studio2:box_functions:logic_control:mcs|MCS]] | Starts a master control zone at a level from 0 to 15. | 
-|  | [[en-us_products:mpino_studio2:box_functions:logic_control#mcsclr|MCSCLR]] | Ends the master control zone at the specified level and any inner zones. |+|  | [[en-us_products:mpino_studio2:box_functions:logic_control:mcsclr|MCSCLR]] | Ends the master control zone at the specified level and any inner zones. |
 | Free-form Box Functions | [[en-us_products:mpino_studio2:box_functions:free_input|Free-form Box Functions]] | ''D0 = D0 + 1'' · ''R0 += 1.5'' · ''D0 = readSensor()'' | | Free-form Box Functions | [[en-us_products:mpino_studio2:box_functions:free_input|Free-form Box Functions]] | ''D0 = D0 + 1'' · ''R0 += 1.5'' · ''D0 = readSensor()'' |
  
-===== 8. Check Build Errors =====+===== 7. Check Build Errors =====
  
 An invalid command or argument appears as a build error. Check the ladder name and row in the message, then reopen that box function. An invalid command or argument appears as a build error. Check the ladder name and row in the message, then reopen that box function.
Line 118: Line 124:
  
 ===== Related Documentation ===== ===== Related Documentation =====
 +
 +  * [[en-us_products:mpino_studio2:monitoring|Phase 6 · Serial and Ladder Monitoring]]
 +
 +  * [[en-us_products:mpino_studio2:code_editor|Phase 5 · Editing Arduino Code]]
  
   * [[en-us_products:mpino_studio2:ladder_editing|Phase 3 · Ladder Editing Basics]]   * [[en-us_products:mpino_studio2:ladder_editing|Phase 3 · Ladder Editing Basics]]
en-us_products/mpino_studio2/box_functions.1788963606.txt.gz · Last modified: by 127.0.0.1
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki