====== MPINO STUDIO 2 Phase 1 · Create Your First Project ======

This document is for first-time MPINO Studio 2 users. You will create a ladder circuit in which **output P32 turns ON while input P0 is ON**, then build, upload, and monitor the project.

^ Application ^ Tutorial board ^ Finished circuit ^
| MPINO Studio 2 | MPINO-8A4R(T)-S | ''P0'' NO contact → ''P32'' output coil |

{{ :en-us_products:mpino_studio2:first-project-flow.svg?1000 |Workflow from creating the first project to checking the running board }}

> **About the screenshots:** The screenshots show the Korean interface. Button positions and keyboard shortcuts are the same as described below.

===== 1. Before You Begin =====

Prepare the following items.

  * A PC with MPINO Studio 2 installed
  * An MPINO-8A4R(T)-S board
  * An MP download cable (for MPINO-8A4R(T)-S)
  * A P0 input signal wired according to the product manual if you will perform the live input test

For the first test, complete programming and uploading with the output load disconnected.

===== 2. Initial Screen =====

MPINO Studio 2 opens **① an Untitled project** that you can edit immediately. The Explorer already contains **② the ''main'' code tab** and **③ the ''ladderLoop'' ladder tab**.

{{ :products:mpino_studio2:first-run-window-marked.svg?1200 |Figure 1. Default project opened at first launch }}

On the first launch, a notice about automatic error reporting appears once. Read the notice and select **OK** to close it. You can later change this option under **File → Preferences → General → Send error reports automatically**.

{{ :products:mpino_studio2:chfirst-run-notice.png?480 |Figure 2. Error-reporting notice displayed at first launch }}

===== 3. Learn the Six Screen Areas =====

Identify these areas before editing the project.

  - **① Menu bar:** File, Edit, View, Run, Settings, and Help
  - **② Activity bar:** Explorer, Ladder Settings, Ladder Pin Map Settings, Library, Symbols, Serial Monitor, and Settings
  - **③ Sidebar:** Project and board information for the selected activity
  - **④ Editor:** Arduino C code or ladder circuit editor
  - **⑤ Bottom panel:** Build output, problems, mnemonic view, and Serial Monitor
  - **⑥ Status bar:** Current status and port selector

{{ :products:mpino_studio2:app-overview-layout-marked.svg?1200 |Figure 3. Main areas of the MPINO Studio 2 window }}

**⑦ Ready** at the lower left is a static label. Use **⑧ Select Port** at the lower right to choose the serial port for uploading.

===== 4. Create a Project and Select the Board =====

  - Select **File → New**, or press ''Ctrl+N''.
  - If the current project contains unsaved changes, choose whether to continue in the confirmation window.
  - In the board selection window, select **① the MPINO-8A4R(T)-S card**.
  - Choose **② Select**, press ''Enter'' on the card, or double-click it. Press ''Esc'' to cancel.
  - When the new project opens, press ''Ctrl+S'' to choose its name and save location.
  - Open **Settings → Ladder Pin Map Settings**, select **Use** for the ''P0'' and ''P32'' rows, and select **OK**.
  - Press ''Ctrl+S'' to save the pin map settings in the project.

{{ :products:mpino_studio2:board-select-modal-marked.svg?1100 |Figure 4. Board selection window with MPINO-8A4R(T)-S selected }}

Selecting the board does not create a file on disk. The name and location of the ''.mp2'' project file are set when you save it.

===== 5. Place the P0 Contact and P32 Coil =====

In the Explorer, select **① Ladder → ladderLoop**. Select a grid cell first, then use a toolbar button or function key to place an element in that cell.

  - Select row 1, column 1, then choose **② NO contact** or press ''F2''.
  - Select row 1, column 2, then choose **③ output coil** or press ''F9''.
  - Press ''Enter'' on **④ the first cell** or double-click it, then enter ''P0'' as the address.
  - Press ''Enter'' on **⑤ the second cell** or double-click it, then enter ''P32'' as the address.
  - Confirm that your screen matches the figure below.

{{ :products:mpino_studio2:ladder-editor-toolbar-marked-phase1.svg?1200 |Figure 5. Ladder circuit with the P0 contact and P32 output coil }}

Press ''Enter'' on **① the selected cell**, or double-click it, to open the edit window. Enter the value in **② the address field**, then choose **③ OK**. Contacts and coils use the same style of input window, so check the selected cell and address before confirming.

{{ :products:mpino_studio2:ladder-cell-edit-modal-marked.svg?1050 |Figure 6. Entering P0 in the contact edit window }}

==== Common Ladder Tools ====

^ Shortcut ^ Tool ^ Purpose ^
| ''F2'' | NO contact | Passes the condition while the input is ON. |
| ''F3'' | NC contact | Passes the condition while the input is OFF. |
| ''F5'' | Horizontal line | Connects the preceding condition to the next cell. |
| ''F6'' | Vertical line | Toggles the vertical connection at the right of the cell. |
| ''F7'' | SET coil | Holds the output after the condition turns ON. |
| ''F8'' | RESET coil | Releases an output held by SET. |
| ''F9'' | Output coil | Applies the condition's ON/OFF state on every scan. |
| ''F11'' | Rising edge | Turns ON for one scan when the state changes from OFF to ON. |
| ''F12'' | Falling edge | Turns ON for one scan when the state changes from ON to OFF. |
| ''Ctrl+Enter'' | Box function | Places a box function such as a timer or counter. |

This tutorial uses only ''F2'' and ''F9''. The completed circuit turns P32 ON while P0 is ON.

===== 6. How the Ladder Runs as Arduino C Code =====

During a build, MPINO Studio 2 converts the ladder data in the ''.mp2'' project into C code and compiles it with the Arduino toolchain. The ''ladderLoop'' tab becomes the ''ladderLoop()'' function.

<code cpp>
void setup() {
}

void loop() {
  ladderLoop();
}
</code>

When ''ladderLoop()'' runs, the ladder logic you created runs. Therefore, it must be called from ''loop()''.

{{ :en-us_products:mpino_studio2:first-project-flow.svg?1000 |Figure 7. MP2 project conversion, build, and upload flow }}

===== 7. Build the Project =====

  - Select **Run → Build**, or press ''Ctrl+R''.
  - Confirm that the bottom panel switches to **① Build Output**.
  - Wait for the compilation log to finish.
  - The build succeeded if the final line contains **② ''[arduino-cli exit 0]''**.

{{ :products:mpino_studio2:build-output-panel-marked.svg?1200 |Figure 8. Build Output after a successful build }}

If the build fails, start with the error summary and the last part of the log. Check the selected board, cell addresses, and code syntax in that order.

===== 8. Select a Port and Upload =====

> **Caution:** Uploading does not start until a port is selected.

  - Connect the MPINO-8A4R(T)-S board to the PC with the MP download cable.
  - In Windows **Device Manager → Ports (COM & LPT)**, check for ''USB Serial Port (COMx)''. If it does not appear, install the [[https://www.ilogics.net/en-us/resources/downloads/driver/1|FTDI driver for the MP download cable]] and reconnect the cable.
  - Select **① Select Port** at the right side of the status bar.
  - Choose the required port, such as ''COM3'', from **② the open port list**.
  - Select **Run → Upload**, or press ''Ctrl+U''.
  - Confirm that the upload log continues below the build log and ends normally.

{{ :products:mpino_studio2:statusbar-port-picker-marked.svg?1200 |Figure 9. Selecting the upload port from the status bar }}

The port list refreshes automatically when the drop-down opens. You can cancel an upload from the bottom panel while it is running.

===== 9. Verify Operation =====

==== Serial Monitor ====

Select **① Serial Monitor** in the Activity bar. Choose **② the baud rate** and **③ character encoding**, then select **④ Connect**. Use **⑤ the ASCII/HEX control** to change the display mode, and check **⑥ the connection state** at the right.

{{ :products:mpino_studio2:serial-monitor-panel-marked.svg?1200 |Figure 10. Connected Serial Monitor }}

==== Real-Time Ladder Monitoring ====

Before using real-time monitoring, select a communication port under **File → Preferences → Ladder Settings → Monitoring Port**, then build and upload again. After that, press ''Ctrl+M'' or select **① Monitoring ON** in the ladder view.

When a physical input signal reaches P0, **② the P0 contact** and **③ the P32 coil** are highlighted. Press ''Esc'' to stop monitoring.

{{ :products:mpino_studio2:ladder-live-monitoring-marked.svg?1200 |Figure 11. Real-time ladder monitoring with P0 and P32 energized }}

===== 10. Phase 1 Shortcuts =====

{{ :en-us_products:mpino_studio2:phase1-shortcuts.svg?1000 |Figure 12. First-project workflow and keyboard shortcuts }}

^ Shortcut ^ Action ^
| ''Ctrl+N'' | New project |
| ''Ctrl+S'' | Save project |
| ''F2'' | Place NO contact |
| ''F9'' | Place output coil |
| ''Ctrl+R'' | Build |
| ''Ctrl+U'' | Upload |
| ''Ctrl+M'' | Toggle real-time ladder monitoring |

===== 11. Completion Checklist =====

You have completed Phase 1 when all of the following are true.

  * You saved the ''.mp2'' project.
  * MPINO-8A4R(T)-S is selected as the board.
  * The first row of ''ladderLoop'' contains the ''P0'' contact and ''P32'' coil.
  * The build log ends with ''arduino-cli exit 0''.
  * You selected the correct port and uploaded the project.
  * The P32 coil's monitoring state changes with the P0 input.

===== Follow Along with MPAINO-8A8R(T) =====

For MPAINO-8A8R(T), the first input is ''P0'' and the first output is ''P64''. Use the editing, build, upload, and monitoring controls described above, with the board, output address, and PC connection shown below.

Connect the USB download port on the MPAINO-8A8R(T) CPU module to the PC with a standard USB cable. In Windows **Device Manager → Ports (COM & LPT)**, check for ''Silicon Labs CP210x USB to UART Bridge (COMx)''. If it does not appear, install the [[https://www.ilogics.net/en-us/resources/downloads/driver/2|CP210x driver for models with a built-in bridge]] and reconnect the cable.

^ Item ^ MPINO-8A4R(T)-S example on this page ^ MPAINO-8A8R(T) ^
| Board selection | ''MPINO-8A4R(T)-S'' | ''MPAINO-8A8R(T)'' |
| First digital input | ''P0'' | ''P0'' |
| First digital output | ''P32'' | ''P64'' |

  - Select the ''MPAINO-8A8R(T)'' board under **File → New**, then save the project.
  - Under **Settings → Ladder Pin Map Settings**, check that **Use** is enabled for input ''P0'' and output ''P64'', then save. Confirm that the relay (R) or transistor (T) output type matches the delivered product.
  - Place an NO contact at ''P0'' and an output coil at ''P64'' on the first row of ''ladderLoop''. Figure 5 shows the MPINO example; enter ''P64'' instead of its ''P32'' coil address.
  - Follow **Build → Select the COM port above in the status bar → Upload → Verify Operation**. Check wiring against the [[:en-us_products:mpaino_8a8r|MPAINO-8A8R details]] or the specification for your T model.

Other MPAINO models can have different I/O counts and module configurations. Check the pin map of the selected project board and use the addresses for your model.

===== Troubleshooting =====

^ Symptom ^ What to check ^
| Upload stops immediately. | Make sure a port is selected in the status bar. |
| P0 or the output does not behave as expected. | Check that the selected board matches the physical product. Under **Settings → Ladder Pin Map Settings**, confirm **Use** for input ''P0'' and the model's output address (''P32'' or ''P64''). |
| The ladder does not show energized elements. | Set the monitoring port, then build and upload the project again. |
| The build fails. | Read the last error in Build Output and check the ''main'' code syntax. |


===== Related Documentation =====

  * [[en-us_products:mpino_studio2:monitoring|Phase 6 · Serial and Ladder Monitoring]]
  * [[en-us_products:mpino_studio2:menus_settings#ladder_pin_map_settings|Phase 7 · Ladder Pin Map Settings]]

[[:en-us_products:mpino_studio2|← Return to the MPINO STUDIO 2 manual]]