查看“PC prerequisites”的源代码

{{Info|Recommended setup: Native Linux PC}}

== Purpose ==
This article explains and describes the hardware configuration required to be able to activate and run the STM32 MPU platforms.

== Recommended PC configurations ==
The PC requirements depend on the [[Which Package better suits your needs|Package you want to use]].

The table below guides through the selection and configuration of the host PC environment according the targeted Package:
{| class="st-table" 
|-
! Host Environment !! Starter Package !! Developer Package !! Distribution Package
|-
| '''Windows (64 bits) '''<br>&emsp;Tested with Windows7 and Windows10<br>&emsp;Preferred version Windows 10 || native || [[PC_prerequisites#Virtual Machine installation|Virtual Machine]] || [[PC_prerequisites#Virtual Machine installation|Virtual Machine]] 
|-
| '''Linux (64 bits)'''<br>&emsp;Tested with Ubuntu '''18.04''' and 16.04 || native || native + additional packages (see [[#Linux PC|Linux PC]] chapter ) || native + additional packages  (see [[#Linux PC| Linux PC]] chapter )
|}


There are no absolute minimal requirements regarding the PC hardware configuration, however ST recommends to meet or exceed the following hardware configurations when using '' Developer Package'' or ''Distribution Package''.

The table below correspond to the minimal validated configuration:
{| class="st-table"
|-
! Hardware item !! Minimal validated configuration !! Comments / Recommendations
|-
| CPU || core i5-2540M @ 2.6GHz <br> 2 cores (4 threads) <br> 3MB cache || '''64 bits instruction set is mandatory''' <br> '''8 cores/threads or more''' is a good config moreover for ''Developer Package'' and ''Distribution Package''.  
|-
| RAM || 8GB || '''16GB or more''' is recommended especially for ''Virtual Machine'' setup , ''Developer Package'' and ''Distribution Package''.
|-
| Hard Drive || 320GB || '''1TB''' is probably a better config when using ''Distribution Package''  
|}

==Windows PC==
'''''Starter Package'' may run on Windows.''' <br>
'''''Developer Package'' and ''Distribution Package'' require a Linux environment.'''

{{Warning|ST solutions, while reportedly functional when running on a Linux Virtual machine, are only validated for Linux native setups ...}}<br />

There are several ways to run Linux system on top of a Windows host PC, ST recommends to use a [[#Virtual Machine System|Virtual Machine System]]:
# Install a virtual machine such as  VMWare <ref> http://vmware.com </ref>
# Setup a '''64 bits''' Ubuntu image compatible with your virtual machine

ST, in an experimental way, has also run ''Developer Package'' and ''Distribution Package'' on a WSL2 (Windows Subsystem for Linux 2); see [[#WSL2 (experimental)|WSL2 chapter]].

===Virtual Machine System===
====Virtual Machine installation====
{{InternalInfo|For ST employees you must use VMware Workstation player, other virtual machines are forbidden (VirtualBox, ...)}}

ST has selected VMWare as Linux virtual machine solution.

VMWare is a commercial company specialized in virtualization solutions. The available solutions to support a virtual Linux machine on a Windows PC are:
* VMWare Workstation Player (paid solution) for commercial use (download  here <ref> https://my.vmware.com/en/web/vmware/free#desktop_end_user_computing/vmware_workstation_player/15_0 </ref>)
* VMWare Workstation Player (free solution) for home use (download here <ref> https://www.vmware.com/products/workstation-player/workstation-player-evaluation.html</ref>)

Please proceed with the installation of the virtual machine.

{{highlight|Before running the virtual machine, make sure the virtualization is activated in the BIOS (it should be activated by default for any retail PC).}}

{{InternalInfo|PCs from ICT are delivered with virtualization deactivated in the BIOS, please call 8787 to enable it}}


====Download the Ubuntu image for the virtual machine====
The "osboxes.org" <ref> http://osboxes.org </ref> website provides virtual machine images compatible with VMWare(*.vmdk).<br>

{{highlight|Setup have been validated and tested on Ubuntu 18.04 (64bit)}}<span style="color: #D4007A;"> and Ubuntu 16.04 (64bit).</span>

Download the 64 bits Ubuntu image available at <ref> https://www.osboxes.org/ubuntu/#ubuntu-1804-vmware </ref> and:
# Unzip the downloaded file
# In VMware create a virtual machine using the Ubuntu virtual disk downloaded from osboxes.org.<br>
The recommended usage is to dedicate, at least, half of the host machine to the virtual machine:
 - CPU: 2 cores at least,
 - RAM: 6 Gbytes or more is a good choice (the more RAM allocated to Virtual Machine the better - the RAM allocated to Virtual Machine must be 4GB minimum),
 - Network: NAT is good and an easy way to benefit form a network connection within the virtual machine.

{{highlight|Virutal size of virtual disk downloaded from osboxes.org is about 500GB. Even if the real size of the file of the virtual disk is less at beginning, the size could growth up to 500GB over compiling distribution package or development package.}}
{{info|{{highlight|For VMware}}, you need first to create a default virtual machine then add the ''.vmdk'' file, previously downloaded.<br>
Please refer to the [[media:VMwarePlayerHelp.pdf|VMwarePlayer screenshot tutorial]].}}

====Launch of Ubuntu image====
{{Warning | For "AZERTY" keyboard users:<br>
The default keyboard configuration is "QWERTY".<br>
In order to configure the keyboard for "AZERTY", start by opening a session (take care that the keyboard layout is QWERTY).<br>
TIP: the password for the default user "''osboxes.org''" is "''osboxes.org''".<br>
TIP: the '.' character is obtained by clicking ':' on an AZERTY keyboard configured in QWERTY.<br>
Once the session is opened, click the 'En' icon on top/right of the screen, select the French ('Fr') keyboard layout and move it to the first position in the list.<br>
Optionally the 'En' keyboard can be completely removed. If the 'Fr' option is not present, it can be added with the 'Text entry setting' menu.}}
Default '''Credentials''' of the Ubuntu ''' are set to "osboxes.org" for both login and password.'''

{{Warning | Adjust screen resolution:<br>
The (default) resolution used by the virtual machine is 800x600 (smallest available). It is not automatically adjusted to the display resolution.
In order to adjust the resolution, click the "settings" icon ('toothed wheel' on top/right of the screen), then "system&#xa0;settings&#xa0;..."&#xa0;>&#xa0;"display" and select the appropriate resolution for the display (do not to forget to click the "Apply" button on bottom/left of the "Screen Resolution Setting" window).}}

For a better experience with the VMware virtual machine, install "vmware-tools" in order to be able to use the clipboard to drag-and-drop and copy/paste files between VMware and Windows.
A step-by-step installation procedure of '''vmware-tools''' is available in the document: [[media:PreRequisite-Vmware-tools.pdf|PreRequisite-Vmware-tools.pdf]]


The virtual machine is up and running!

{{highlight|The Ubuntu setup must be finalized according recommendations provided in [[#Linux PC |Linux PC ]] chapter}}

{{Warning | USB connection's  speed:<br>
USB connection is requested for accessing STLink (debugger and serial port) and by STM32CubeProgrammer. The speed of the USB connection  between Linux running in the virtual machine and the external USB devices can be severely impacted by:
* the virtual machine USB setup;
* the USB controller in the host PC;
* the USB device connected to host PC;
* any USB hub between the USB host and the USB device.
If the speed of your USB connection is too low, we suggest to:
* try different USB configurations of the virtual machine;
* connect the USB device directly on the host USB port (without any USB hub);
* try connecting the USB device to another USB port of the host (some PC have different USB controller on different USB port).
}}

===WSL2 (experimental)===
Even if STMicroelectronics strongly recommends to use a Linux® environment, the ''Developer Package'' and ''Distribution Package'' works in WSL2 (Windows Sub-system Linux 2) environment. WSL is a feature provided by '''Windows 10®'''.<br/>
ST has run unsuccessfully ''Developer Package'' and ''Distribution Package'' on WSL but successfully on WSL2.
WSL2 is available on Windows 10® since build 18917.


WSL 2 is a new version of the architecture that powers the Windows Subsystem for Linux to run ELF64 Linux binaries on Windows (more details on [http://aka.ms/wsl2 aka.ms/wsl2]).

* <u>WSL2 - Installation</u> : 
** To install WSL2 please read this webpage:  [https://docs.microsoft.com/fr-fr/windows/wsl/wsl2-install https://docs.microsoft.com/fr-fr/windows/wsl/wsl2-install]
** Once WSL2 installed, jump to chapter [[#Linux_PC]] to make your WSL2 ready to run ''Developer Package'' and/or ''Distribution Package''.
* <u>WSL2 - Limitations</u> : 
** WSL2 up to now (09/2019) does not support hardware such as USB devices, serial, ... ([https://docs.microsoft.com/fr-fr/windows/wsl/wsl2-faq#can-i-access-the-gpu-in-wsl-2-are-there-plans-to-increase-hardware-support more details]).
**: This means, STM32CubeProgrammer should be used through native Windows
** WSL2 files are not browsable from Windows native file explorer.
**: To share files between WSL2 and Windows, the prefered way is to use the mount point ''/mnt/c'' from WSL2 and do copies.
* <u>WSL2 - Tips</u> : 
** Launch graphical application : On ''wiki.ubuntu.com'' the page on [https://wiki.ubuntu.com/WSL WSL] contains a chapter [https://wiki.ubuntu.com/WSL#Running_Graphical_Applications Running Graphical Applications].

===References===
<references/>

<noinclude>
[[Category:Prerequisites]]
[[Category:STM32 MPU boards]]
{{PublicationRequestId | 8347  | 2018-08-22| BrunoB}}
</noinclude>