[WEDO-7111] 2.1.2

content/software/app-labs/software.md

@@ -0,0 +1,6 @@
+---
+title: App Labs
+icon: IconBrackets
+---
+
+Focus on your project with seamless MPU and MCU development.

content/software/app-labs/tutorials/Linux/Linux.md

@@ -0,0 +1,70 @@
+---
+author: 'Arduino'
+description: 'Install the Arduino Software (IDE) on Linux'
+title: 'Arduino IDE 1 Installation (Linux)'
+tags: [Installation, Linux]
+---
+
+This document explains how to install the Arduino Software (IDE) on Linux machines.
+
+## Quick Start
+
+The Linux build of the Arduino Software (IDE) comes in different packages depending on your system architecture. There are no specific instructions needed for the different distributions of Linux (e.g. Ubuntu).
+
+### Download the Arduino Software (IDE)
+
+Get the latest version from the [download page](https://www.arduino.cc/en/Main/Software). You can choose between the 32, 64 and ARM versions. It is very important that you choose the right version for your Linux distro. Clicking on the chosen version brings you to the donation page and then you can either open or save the file. Please save it on your computer.
+
+![Save the file.](assets/Linux_Download.jpg)
+
+### Extract the package
+
+The file is compressed and you have to extract it in a suitable folder, remembering that it will be executed from there.
+
+![Extracting the package.](assets/Linux_Extract.jpg)
+
+### Run the Install Script
+
+Open the **arduino-1.x.x** folder just created by the extraction process and spot the **install.sh** file. Right click on it and choose **Run in Terminal** from the contextual menu. The installation process will quickly end and you should find a new icon on your desktop.
+
+If you don't find the option to run the script from the contextual menu, you have to open a Terminal window and move into the **arduino-1.x.x** root directory and run the following command:
+
+```
+sudo sh install.sh
+```
+***This method only works for versions greater or equal than 1.6.5.  Remove `sudo` keyword if already running the terminal with administrative rights.***
+
+
+You should find a new icon on your desktop.
+
+![Running the installation script.](assets/Linux_Install_2.jpg)
+
+## Please Read
+
+It might happen that when you upload a sketch - after you have selected your board and the serial port -, you get an error _Error opening serial port ..._
+If you get this error, you need to set serial port permission.
+
+Open Terminal and type:
+
+`ls -l /dev/ttyACM*`
+
+you will get something like:
+
+`crw-rw---- 1 root dialout 188, 0 5 apr 23.01 ttyACM0`
+
+The "0" at the end of ACM might be a different number, or multiple entries might be returned. The data we need is "dialout" (is the group owner of the file).
+
+Now we just need to add our user to the group:
+
+`sudo usermod -a -G dialout <username>`
+
+where `<username>` is your Linux user name. **You will need to log out and log in again for this change to take effect.**
+
+![Adding user to the group.](assets/Ubuntu_Serial.jpg)
+
+This is the procedure to access the serial port from the Arduino Software (IDE) if you get an error
+
+After this procedure, you should be able to proceed normally and upload the sketch to your board or use the Serial Monitor.
+
+The text of the Arduino getting started guide is licensed under a
+[Creative Commons Attribution-ShareAlike 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/). Code samples in the guide are released into the public domain.

content/software/app-labs/tutorials/PortableIDE/PortableIDE.md

@@ -0,0 +1,46 @@
+---
+author: 'Arduino'
+description: 'How to create and use a portable version of the Arduino Software (IDE)'
+title: 'Arduino IDE 1 Portable Installation'
+tags: [Software, Portable]
+---
+
+This document explains how to make a portable installation of the Arduino Software (IDE) on Windows and Linux machines. A portable installation contains all the files and directories necessary to get the Arduino Software (IDE) to work on a computer without affecting its files outside the folder designated for the portable installation.
+
+## Why Portable?
+
+Almost in all the schools students don't have administrator privileges, so they don't have write access in some folders. This leads to some problem in using the Arduino Software (IDE) since your preferences and sketchbook are saved in one of those folders. Using a portable version of the IDE you can overcome this problem.
+
+Another scenario can be the following: you want to organize a workshop and you need some additional [library](/learn/starting-guide/software-libraries) or a specific [core](/learn/starting-guide/cores). Since the portable version stores the sketchbook, the libraries and the hardware folder locally, you can have a starting point equal for all the people who join the workshop just replicating the same folder on all the machines. This is also quite useful if for some reason you don't have an internet connection and want to prepare everything for your project without downloads and delays.
+
+Furthermore, a portable installation could be on a pendrive, allowing you to carry around your personal set of sketches, cores and libraries, to be used on any computer without affecting it with your files.
+
+## Windows & Linux
+
+The procedure is made of a few simple steps. You may use a pendrive or a local folder on your machine. Once done, with libraries and additional cores where needed, that folder can be copied on other machines.
+
+- [Download](https://www.arduino.cc/en/Main/Software) a compressed version of the Arduino IDE according to your OS;
+
+- Once download has been completed, extract the archive content on the chosen unit (local or pendrive);
+
+- Open the extracted folder and in its root create a new directory called **_portable_**, alongside the others;
+
+![Portable Tree](assets/Portable_Tree.png)
+
+The tree structure should be as this one; the **portable** folder will be populated by the Arduino Software (IDE) as needed by libraries, sketches and cores.
+
+To use this installation, launch the Arduino executable;
+
+From now on all the sketches, libraries and additional cores will be installed in the **_portable_** folder. You can copy the whole main folder and bring it with you anywhere you want: it will retain all your preferences, libraries, cores and sketches.
+
+## MacOS Note
+
+The portable installation is not officially supported on Apple's Mac operating systems for several reasons. One of them is related to the package signature (we sign the Arduino IDE package): adding any content - like additional cores, libs and sketches - to the package will break the signature. A consequence of that is the reaction of the Gatekeeper that could even stop the app from starting. This is related to the OS and not to our IDE. Anyway, if you want to experiment you can check [this forum thread](http://forum.arduino.cc/index.php?topic=539551.msg3678998#msg3678998) and try by yourself the solutions developed by the community.
+
+## Updating Portable Installation
+
+If you want to update a portable installation to a newer version, download the new version in compressed format, then extract the contents in a temporary folder. Now you may either move the "portable" folder you have from the old installation into the new one, or copy all the files of the new version onto the old one, overwriting all the files. Either way you should end up with the updated portable Arduino Software (IDE) installation with your cores, libraries and sketches preserved. Remember to rename the root folder with the proper release version, if needed.
+You should always launch the executable file "Arduino" from inside the folder of your portable installation to use the sketches, cores and libraries contained in it. If you have another installation of the Arduino Software (IDE) on the machine you are using, that version won't be affected. Libraries and cores already installed on the machine won't be seen or used by the portable installation.
+
+The text of the Arduino getting started guide is licensed under a
+[Creative Commons Attribution-ShareAlike 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/). Code samples in the guide are released into the public domain.

content/software/app-labs/tutorials/Windows/Windows.md

@@ -0,0 +1,27 @@
+---
+author: 'Arduino'
+description: 'Install the Arduino Software (IDE) on Windows'
+title: 'Arduino IDE 1 Installation (Windows)'
+tags: [Installation, Windows]
+---
+
+This document explains how to install the Arduino Software (IDE) on Windows machines.
+
+## Download the Arduino Software (IDE)
+
+Get the latest version from the [download page](https://www.arduino.cc/en/Main/Software). You can choose between the Installer (.exe) and the Zip packages. We suggest you use the first one that installs directly everything you need to use the Arduino Software (IDE), including the drivers. With the Zip package you need to install the drivers manually. The Zip file is also useful if you want to create a [portable installation](https://arduino.cc/en/Guide/PortableIDE).
+
+When the download finishes, proceed with the installation and please allow the driver installation process when you get a warning from the operating system.
+
+![Choose the components to install.](assets/DRV_Capture1.png)
+
+
+![Choose the installation directory.](assets/DRV_Capture2.png)
+
+
+![Installation in progress.](assets/DRV_Capture3.png)
+
+The process will extract and install all the required files to execute properly the Arduino Software (IDE)
+
+The text of the Arduino getting started guide is licensed under a
+[Creative Commons Attribution-ShareAlike 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/). Code samples in the guide are released into the public domain.