@@ -15,8 +15,11 @@ Hardware setup
15
15
**************
16
16
17
17
The Intel |reg | NUC (NUC6CAYH) is the supported reference target
18
- platform for ACRN work, as described in :ref: `hardware `, and is the only
19
- platform currently tested with these setup instructions.
18
+ platform for ACRN work, as described in :ref: `hardware `, and is the main
19
+ platform currently tested with these setup instructions. The
20
+ `UP Squared board <http://www.up-board.org/upsquared/ >`_ (UP2) is also
21
+ known to work and the few specificities for it are described
22
+ in :ref: `getting_started_up2 `.
20
23
21
24
The recommended NUC hardware configuration is:
22
25
@@ -26,9 +29,6 @@ The recommended NUC hardware configuration is:
26
29
- Memory: 8G DDR3
27
30
- SSD: 120G SATA
28
31
29
- Software setup
30
- **************
31
-
32
32
Firmware update on the NUC
33
33
==========================
34
34
@@ -37,12 +37,15 @@ Follow these `BIOS Update Instructions
37
37
<https://www.intel.com/content/www/us/en/support/articles/000005636.html> `__
38
38
for downloading and flashing an updated BIOS for the NUC.
39
39
40
+ Software setup
41
+ **************
42
+
40
43
Set up a Clear Linux Operating System
41
44
=====================================
42
45
43
46
Currently, an installable version of ARCN does not exist. Therefore, you
44
- need to setup a base Clear Linux OS to bootstrap ACRN on the NUC . You'll
45
- need a network connection for your NUC to complete this setup.
47
+ need to setup a base Clear Linux OS to bootstrap ACRN on your platform . You'll
48
+ need a network connection for your platform to complete this setup.
46
49
47
50
.. note ::
48
51
ACRN requires Clear Linux version 22140 or newer. The instructions below
@@ -54,10 +57,10 @@ need a network connection for your NUC to complete this setup.
54
57
https://download.clearlinux.org/releases/22140/clear/clear-22140-installer.img.xz
55
58
and follow the `Clear Linux installation guide
56
59
<https://clearlinux.org/documentation/clear-linux/get-started/bare-metal-install> `__
57
- as a starting point for installing Clear Linux onto your NUC . Follow the recommended
58
- options for choosing an **Automatic ** installation type, and using the NUC 's
60
+ as a starting point for installing Clear Linux onto your platform . Follow the recommended
61
+ options for choosing an **Automatic ** installation type, and using the platform 's
59
62
storage as the target device for installation (overwriting the existing data
60
- and creating three partitions on the NUC 's SSD drive).
63
+ and creating three partitions on the platform 's storage drive).
61
64
62
65
#. After installation is complete, boot into Clear Linux, login as
63
66
**root **, and set a password.
@@ -97,7 +100,7 @@ need a network connection for your NUC to complete this setup.
97
100
Add the ACRN hypervisor to the EFI Partition
98
101
============================================
99
102
100
- In order to boot the ACRN SOS on the NUC , you'll need to add it to the EFI
103
+ In order to boot the ACRN SOS on the platform , you'll need to add it to the EFI
101
104
partition. Follow these steps:
102
105
103
106
#. Mount the EFI partition and verify you have the following files:
@@ -119,6 +122,13 @@ partition. Follow these steps:
119
122
and ``*-standard ``) listed on your system,
120
123
as you will need them later.
121
124
125
+ .. note ::
126
+ The EFI System Partition (ESP) may be different based on your hardware.
127
+ It will typically be something like ``/dev/mmcblk0p1 `` on platforms
128
+ that have an on-board eMMC or ``/dev/nvme0n1p1 `` if your system has
129
+ a non-volatile storage media attached via a PCI Express (PCIe) bus
130
+ (NVMe).
131
+
122
132
#. Put the ``acrn.efi `` hypervisor application (included in the Clear
123
133
Linux release) on the EFI partition with:
124
134
@@ -136,9 +146,7 @@ partition. Follow these steps:
136
146
137
147
.. code-block :: none
138
148
139
- # efibootmgr -c -l "\EFI\acrn\acrn.efi" -d /dev/sda1 -p 1 -L ACRN
140
- # cd /mnt/EFI/org.clearlinux/
141
- # cp bootloaderx64.efi bootloaderx64_origin.efi
149
+ # efibootmgr -c -l "\EFI\acrn\acrn.efi" -d /dev/sda -p 1 -L ACRN
142
150
143
151
.. note ::
144
152
Be aware that a Clearlinux update that includes a kernel upgrade will
@@ -193,7 +201,7 @@ partition. Follow these steps:
193
201
.. literalinclude :: ../../hypervisor/bsp/uefi/clearlinux/acrn.conf
194
202
:caption: hypervisor/bsp/uefi/clearlinux/acrn.conf
195
203
196
- On the NUC , copy the ``acrn.conf `` file to the EFI partition we mounted earlier:
204
+ On the platform , copy the ``acrn.conf `` file to the EFI partition we mounted earlier:
197
205
198
206
.. code-block :: none
199
207
@@ -205,6 +213,9 @@ partition. Follow these steps:
205
213
206
214
Use ``blkid `` to find out what your ``/dev/sda3 `` ``PARTUUID `` value is.
207
215
216
+ .. note ::
217
+ It is also possible to use the device name directly, e.g. ``root=/dev/sda3 ``
218
+
208
219
#. Add a timeout period for Systemd-Boot to wait, otherwise it will not
209
220
present the boot menu and will always boot the base Clear Linux
210
221
@@ -265,7 +276,7 @@ directory. Run it to create a network bridge:
265
276
Set up Reference UOS
266
277
====================
267
278
268
- #. On your NUC , download the pre-built reference Clear Linux UOS image into your
279
+ #. On your platform , download the pre-built reference Clear Linux UOS image into your
269
280
(root) home directory:
270
281
271
282
.. code-block :: none
@@ -295,7 +306,7 @@ Set up Reference UOS
295
306
# umount /mnt
296
307
# sync
297
308
298
- #. Edit and Run the launch_uos.sh script to launch the UOS.
309
+ #. Edit and Run the `` launch_uos.sh `` script to launch the UOS.
299
310
300
311
A sample `launch_uos.sh
301
312
<https://raw.githubusercontent.com/projectacrn/acrn-hypervisor/master/devicemodel/samples/nuc/launch_uos.sh> `__
0 commit comments