CopterExpress/clover
1
0
Fork 0
mirror of https://github.com/CopterExpress/clover.git synced 2026-06-07 01:59:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add article on installation the simulator on M1 computers

Browse Source
This commit is contained in:
Oleg Kalachev
2022-02-22 19:17:28 +03:00
parent 21bbc8a86c
commit dc06ba1bd2
6 changed files with 108 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/en/SUMMARY.md
View File

@@ -50,6 +50,7 @@
* [Native setup](simulation_native.md)
* [VM setup](simulation_vm.md)
* [Usage](simulation_usage.md)
* [Setup on M1 computers](simulation_m1.md)
* [ROS](ros.md)
* [MAVROS](mavros.md)
* [Supplementary materials](supplementary.md)

53
docs/en/simulation_m1.md Normal file
View File

@@ -0,0 +1,53 @@
# Running simulator on M1 powered computer
There is no preconfigured VM image for ARM64 architecture of M1 chip (Apple Silicon), so the only possibility is to install the simulation software manually.
The recommended virtual machine hypervisor is [UTM app](https://mac.getutm.app/). Also it's possible to use **VMware Fusion Public Tech Preview** with M1 support.
## Simulation installation with UTM
<img src="../assets/simulation_utm.png" width=500 class="center zoom">
1. Download UTM App from the official site [mac.getutm.app](https://mac.getutm.app/) and install it.
2. Download Ubuntu Linux 20.04 installation iso-file for ARM64 architecture using the link: https://cdimage.ubuntu.com/focal/daily-live/current/focal-desktop-amd64.iso.
3. Create a new virtual machine in UTM, using the following settings:
* **Type**: Virtualize.
* **Operating System**: Linux.
* **Memory**: 4096 MB or more.
* **CPU Cores**: 4 or more.
* Turn on *Enable hardware OpenGL acceleration* option.
* **Storage**: 20 GB or more.
4. Run the created virtual machine.
5. Choose *Install Ubuntu* in the menu and install it using the installation master.
* Recommended apps: *Minimal installation*.
* Installation type: *Erase disk and install Ubuntu*.
* Input your account parameters, for example:
<img src="../assets/simulation_ubuntu_account.png" width=400 class="center zoom">
6. Finish the installation and run the system.
7. Install the simulation using the [native setup manual](simulation_native.md).
### Troubleshooting
#### Black screen
If you see a black screen on your virtual machine, try to run the machine without the GPU support.
In virtual machine settings, choose *Display*, and set *Emulated Display Card* menu to *virtio-ramfb*. Run you machine. If it runs successfully, change the setting back to *virtio-ramfb-gl (GPU Supported)* and run it again.
#### Problem with `git clone`
The following error can occur while performing `git clone`:
```txt
on git clone if error: RPC failed; curl 56 GnuTLS recv error (-54): Error in the pull function.
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed
```
In this case, change the type of the network card to bridged. In the virtual machine settings, choose *Network*, and set *Network Mode* menu to *Bridged (Advanced)*.