Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:sw:01-mervis:creating-new-project-on-unipi11-hidden [2021/05/11 12:21]
avsetula
en:sw:01-mervis:creating-new-project-on-unipi11-hidden [2021/09/10 13:07] (current)
avsetula [First project with Unipi 1.1/Lite]
Line 22: Line 22:
   - [[https://​www.unipi.technology/​2gb-prumyslova-microsd-pametova-karta-slc-p232|MicroSD card]] for the PLC    - [[https://​www.unipi.technology/​2gb-prumyslova-microsd-pametova-karta-slc-p232|MicroSD card]] for the PLC 
   - MicroSD->​SD adapter or a microSD card reader with USB connector   - MicroSD->​SD adapter or a microSD card reader with USB connector
-  - [[https://​www.unipi.technology/​napajeci-zdroj-pro-din-listu-5v-dc-2-4a-p65?​categoryId=15|5 ​VDC / 2 A power supply]] +  - [[https://​www.unipi.technology/​napajeci-zdroj-pro-din-listu-5v-dc-2-4a-p65?​categoryId=15|5 ​V⎓ / 2 A power supply]] 
-  - Downloaded archive with [[en:files:software:os-images:00-start#​unipi_11_mervis_os|Mervis OS for Unipi 1.1/​Lite]] +  - Downloaded archive with [[en:hw:03-unipi11:download-image:01-mervis|Mervis OS for Unipi 1.1/​Lite]] 
-  - Computer with [[cs:​files:​software:​mervis:​00-start|Mervis IDE]] installed. ​+  - Computer with [[en:​files:​software:​mervis:​00-start|Mervis IDE]] installed. ​
  
 {{ :​files:​img_breakline_2.png?​nolink |}} {{ :​files:​img_breakline_2.png?​nolink |}}
Line 31: Line 31:
   - [[en:​sw:​01-mervis:​01-mervis-ide| Get to know Mervis IDE]]   - [[en:​sw:​01-mervis:​01-mervis-ide| Get to know Mervis IDE]]
   - [[en:​sw:​01-mervis:​connecting-to-unipi-hidden| Connect the PLC to your computer]]   - [[en:​sw:​01-mervis:​connecting-to-unipi-hidden| Connect the PLC to your computer]]
-  - [[en:​sw:​01-mervis:​running-on-neuron-hidden#​mervis_on_unipi_neuron_11| Deploy Mervis OS to the SD card]]+  - [[en:​sw:​01-mervis:​running-on-unipi11-hidden| Deploy Mervis OS to the SD card]]
   - Plug in the power supply and wait for at least a minute until the PLC's OS boots up.    - Plug in the power supply and wait for at least a minute until the PLC's OS boots up. 
 </​WRAP>​ </​WRAP>​
Line 57: Line 57:
 {{ :​en:​sw:​01-mervis:​04_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​04_creating-new-project-on-unipi11_en.png?​direct |}}
  
-The **Attach Controller** dialogue will appear, in which we can specify, how the Mervis IDE should connect to the controller. If the PLC is in the same LAN network, you can use the **UDP Broadcast** and then click on **Next >**.+The **Attach Controller** dialogue will appear, in which we can specify, how the Mervis IDE should connect to the controller. If the PLC is in the same LAN network, you can use the **UDP Broadcast** and then click on **Next >**.
  
 {{ :​en:​sw:​01-mervis:​05_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​05_creating-new-project-on-unipi11_en.png?​direct |}}
  
-You will now be prompted to enter a username and password (SSCP access) to connect to the controller. The default setting is: **admin / rw**. Now leave and click **Next >​**. ​+You will now be prompted to enter a username and password (SSCP access) to connect to the controller. The default setting is: **admin / rw**. Now leave and click **Next >​**. ​
  
 {{ :​en:​sw:​01-mervis:​06_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​06_creating-new-project-on-unipi11_en.png?​direct |}}
Line 69: Line 69:
 {{ :​en:​sw:​01-mervis:​07_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​07_creating-new-project-on-unipi11_en.png?​direct |}}
  
-After the searching is finished, you will be presented with the list of all detected controllers. The target controller has its name displayed in the **Platform** tab. This tutorial used Unipi 1.1 device - in your case, choose whatever controller you are using and click on **Next**.+After the searching is finished, you will be presented with the list of all detected controllers. The target controller has its name displayed in the **Platform** tab. This tutorial used Unipi 1.1 device - in your case, choose whatever controller you are using and click on **Next >**.
  
 {{ :​en:​sw:​01-mervis:​08_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​08_creating-new-project-on-unipi11_en.png?​direct |}}
Line 99: Line 99:
  
 ===== Connecting inputs/​outputs ===== ===== Connecting inputs/​outputs =====
-In Mervis IDE you now have Unipi 1.1/Lite attached. Construction-wise,​ Unipi controllers consist of a computing module (Raspberry Pi in our case) and a circuit board with inputs and outputs. The board communicates with the computer using **Modbus TCP** and **I2C**. This is the reason why you need to set up **two** communication channels to control Unipi 1.1/1.1 Lite boards. The first channel is for controlling analog and digital I/Os via Modbus TCP protocol while the I2C channel controls relay outputs. ​+In Mervis IDE you now have Unipi 1.1/Lite attached. Construction-wise,​ Unipi controllers consist of a computing module (Raspberry Pi in our case) and a circuit board with inputs and outputs. The board communicates with the computer using **Modbus TCP** and **I²C**. This is the reason why you need to set up **two** communication channels to control Unipi 1.1/1.1 Lite boards. The first channel is for controlling analog and digital I/Os via Modbus TCP protocol while the I²C channel controls relay outputs. ​
  
 Add two **communication channels** to the PLC. TO add a channel right-click on the **PLC** name and then click on **Add Channel**. Repeat for the second channel. ​ Add two **communication channels** to the PLC. TO add a channel right-click on the **PLC** name and then click on **Add Channel**. Repeat for the second channel. ​
Line 109: Line 109:
 {{ :​en:​sw:​01-mervis:​12_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​12_creating-new-project-on-unipi11_en.png?​direct |}}
  
-If you click on the first channel, its properties will appear in the right panel. The first item determines the channel'​s name; we recommend to give channels descriptive names - in this case, I2C will do. +If you click on the first channel, its properties will appear in the right panel. The first item determines the channel'​s name; we recommend to give channels descriptive names - in this case, I²C will do. 
  
-Click on **no protocol** and select **PlatformIO** from the list. By doing so more options will appear - all you need to do here is to make sure the **link protocol** is set to **I2C**. +Click on **no protocol** and select **PlatformIO** from the list. By doing so more options will appear - all you need to do here is to make sure the **link protocol** is set to **I²C**. 
  
 The first channel for relay outputs is already set.  The first channel for relay outputs is already set. 
Line 125: Line 125:
 With both channels configured we can now move to add individual devices. These device definitions **are different between Unipi 1.1 and Unipi 1.1 Lite**, making the correct selection of definition necessary. ​ With both channels configured we can now move to add individual devices. These device definitions **are different between Unipi 1.1 and Unipi 1.1 Lite**, making the correct selection of definition necessary. ​
  
-==== I2C ==== +==== I²C ==== 
-In the **left panel** right-click on the I2C channel. Select **Add Library Device** from the context menu. +In the **left panel** right-click on the I²C channel. Select **Add Library Device** from the context menu. 
  
 {{ :​en:​sw:​01-mervis:​15_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​15_creating-new-project-on-unipi11_en.png?​direct |}}
  
-In the **Add Library Device** dialogue window you will see a list of devices. Find and expand the **Unipi (v1.1)** folder and move to the **I2C** subfolder. Select the suitable device definition accordingly (eg. **Analog-Inputs + Unipi1_Relays** for Unipi 1.1 and **Unipi1Lite_Relay** for Unipi 1.1 Lite). If you have the definition selected, click on the arrow icon {{:​files:​dialog_arrow_right.png?​nolink|}} to add the controller into the list of the selected device. After that, you need only to confirm by clicking on OK. +In the **Add Library Device** dialogue window you will see a list of devices. Find and expand the **Unipi (v1.1)** folder and move to the **I²C** subfolder. Select the suitable device definition accordingly (eg. **Analog-Inputs + Unipi1_Relays** for Unipi 1.1 and **Unipi1Lite_Relay** for Unipi 1.1 Lite). If you have the definition selected, click on the arrow icon {{:​files:​dialog_arrow_right.png?​nolink|}} to add the controller into the list of the selected device. After that, you need only to confirm by clicking on OK. 
  
 {{ :​en:​sw:​01-mervis:​16_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​16_creating-new-project-on-unipi11_en.png?​direct |}}
Line 145: Line 145:
 {{ :​en:​sw:​01-mervis:​18_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​18_creating-new-project-on-unipi11_en.png?​direct |}}
  
-The new device will appear below the corresponding ​I2C / Modbus TCP channel. ​+The new device will appear below the corresponding ​I²C / Modbus TCP channel. ​
  
 {{ :​en:​sw:​01-mervis:​19_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​19_creating-new-project-on-unipi11_en.png?​direct |}}
Line 172: Line 172:
  
  
-===== Building and uploading ​the solution (project) =====+===== Building and Deploying ​the solution (project) =====
  
 ==== Solution building ==== ==== Solution building ====
Line 190: Line 190:
  
 ==== Deploying the solution ==== ==== Deploying the solution ====
-Deploying a solution means compiling and then uploading the created binary file to the controller and running it in **Full run**. Click **Deploy Solution** on **upper ribbon** to deploy the solution.+**Deploying a solution means:** compiling and then uploading the created binary file to the controller and running it in **Full run**. Click **Deploy Solution** on **upper ribbon** to deploy the solution.
  
 {{ :​en:​sw:​01-mervis:​26_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​26_creating-new-project-on-unipi11_en.png?​direct |}}
Line 241: Line 241:
 {{ :​en:​sw:​01-mervis:​36_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​36_creating-new-project-on-unipi11_en.png?​direct |}}
  
-You now need to connect the pulse generator'​s output to Relay1 input. Right-click on **input section** to display a context menu, move the cursor over **Global Variables** and from the submenu choose **Insert existing variable**. ​+You now need to connect the pulse generator'​s output to **Relay1** input. Right-click on **input section** to display a context menu, move the cursor over **Global Variables** and from the submenu choose **Insert existing variable**. ​
  
 {{ :​en:​sw:​01-mervis:​37_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​37_creating-new-project-on-unipi11_en.png?​direct |}}
  
-In the Insert existing ​variables, a list of all available variables, inputs and outputs of your controller will be displayed. If the list is nearly empty, you probably did not use Autogen to define variables available for your PLC. In that case, right-click on devices in both I2C and Modbus TCP channels and click on **Set autogen** in the context menu. +In the **Insert existing ​variable**, a list of all available variables, inputs and outputs of your controller will be displayed. If the list is nearly empty, you probably did not use Autogen to define variables available for your PLC. In that case, right-click on devices in both I²C and Modbus TCP channels and click on **Set autogen** in the context menu. 
  
 If you followed the guide closely, Simple Mode already generated all variables for the program. If you followed the guide closely, Simple Mode already generated all variables for the program.
Line 267: Line 267:
 {{ :​en:​sw:​01-mervis:​40_creating-new-project-on-unipi11_en.png?​direct |}} {{ :​en:​sw:​01-mervis:​40_creating-new-project-on-unipi11_en.png?​direct |}}
  
-You can now try to **build the solution** - see [[#​building_and_uploading_the_solution_project|Building and uploading the solution]]. If you did everything right, a **Build succeeded** message will appear in the **status bar**. **Warning** messages displayed in the **Results** tab can be safely ignored. ​+Now you can **Build Solution** - see [[#​building_and_uploading_the_solution_project|Building and uploading the solution]]. If you did everything right, a **Build succeeded** message will appear in the **status bar**. **Warning** messages displayed in the **Results** tab can be safely ignored. ​
  
 If the build succeeded and you followed the instructions above correctly, you can **upload** the solution into the controller - see [[#​building_and_uploading_the_solution_project|Building and uploading the solution]]. If the build succeeded and you followed the instructions above correctly, you can **upload** the solution into the controller - see [[#​building_and_uploading_the_solution_project|Building and uploading the solution]].
  
-Upon uploading ​the solution the Relay1 ​relay output will be switched every 5 seconds.  ​+Upon deploying ​the solution the relay output ​**Relay1** ​will be switched every 5 seconds.  ​
  
 ---- ----