Skip to content

Commit

Permalink
Merge branch 'ArmDeveloperEcosystem:main' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
KeilChris authored Dec 1, 2023
2 parents 1a08443 + dc9edb7 commit 43b659b
Show file tree
Hide file tree
Showing 159 changed files with 7,623 additions and 227 deletions.
4 changes: 3 additions & 1 deletion .github/workflows/content-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,9 @@ jobs:
extended: true

- name: Build
run: hugo --minify
run: |
hugo --minify
bin/pagefind --site "public"
- name: Check HTML links
continue-on-error: true
Expand Down
4 changes: 3 additions & 1 deletion .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,9 @@ jobs:

# Builds arm-learning-paths repo
- name: Build
run: hugo --minify
run: |
hugo --minify
bin/pagefind --site "public"
# Copy SSH Key
- name: copy key
Expand Down
4 changes: 3 additions & 1 deletion .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,9 @@ jobs:

# Builds arm-software-developer repo
- name: Build
run: hugo --minify
run: |
hugo --minify
bin/pagefind --site "public"
# Deploys website to AWS S3
- name: Deploy to S3
Expand Down
5 changes: 4 additions & 1 deletion .gitpod.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,10 @@ tasks:
- name: Install Hugo
before: brew install hugo
init: echo "Your version of Hugo is `hugo version`"
command: hugo server -D -F --baseURL $(gp url 1313) --liveReloadPort=443 --appendPort=false --bind=0.0.0.0
command: |
hugo
bin/pagefind --site "public" --output-subdir ../static/pagefind
hugo server -D -F --baseURL $(gp url 1313) --liveReloadPort=443 --appendPort=false --bind=0.0.0.0
ports:
- port: 1313
Expand Down
123 changes: 123 additions & 0 deletions .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -740,6 +740,7 @@ aaarch
abc
accelerometer
acknowledgements
acknowledgement
acnt
acq
ade
Expand Down Expand Up @@ -1615,3 +1616,125 @@ drcachesim
dynamorio
mispredicted
lookaside
devel
glibc
procps
PACBTI
gatord
awscli
dns
Borycki
Dawid
rg
pds
WebApp
AllowAnyCustom
Konstantinos
Margaritis
VectorCamp
ASIMD
enum
solaris
Spickett
Allocator
allocator
pseudocode
struct
allocators
tradeoff
tradeoffs
unallocated
deallocate
prepend
initialise
ptr
LLSoftSecBook
nodeSelector
KMDF
DevCon
LXD
RME
CCA
AEM
Kconfig
buildroot
RMM
Bolt
Optimisation
PGO
llvmorg
latencies
algorithmica
colin
gistcomment
jboner
permalink
scott
SDD
Gbps
datacenter
mispredict
roundtrip
facto
DIMMs
cca
rme
JXrNkYysuXw
enablement
xA
xFFFFFFFF
gpc
rl
GPT
GPTBR
GPCCR
GPC
GPTSZ
PGS
VTTBR
xBxxxxxxx
xxxxxxx
JAX
Keras
jax
keras
Deadsnakes
CPython
Leandro
Nunes
Initializers
Optimizers
rebases
optimizers
IMDB
djangoproject
WSGI
Gunicorn
gunicorn
envoyproxy
hugetlbfs
Pprofdata
profdata
profraw
Xing
Zhengjun
CNCF
Lyft
microservices
VwbgFSoy
fargate
hBHf
microservices
ySm
Fargate’s
LearningPath
Przemyslaw
Wirkus
pe
Googolplex
PDB
DLL
si
PCbuild
cpython
CPython's
Binary file added bin/pagefind
Binary file not shown.
Binary file added bin/pagefind.aarch64
Binary file not shown.
Binary file added bin/pagefind.arm64
Binary file not shown.
Binary file added bin/pagefind.exe
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed content/install-guides/_images/windows-sys-env.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
59 changes: 40 additions & 19 deletions content/install-guides/armpl.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@ additional_search_terms:
minutes_to_complete: 10

### Link to official documentation
official_docs: https://developer.arm.com/downloads/-/arm-performance-libraries#documentation

official_docs: https://developer.arm.com/documentation/101004/latest
author_primary: Pareena Verma

### PAGE SETUP
Expand All @@ -29,78 +28,91 @@ layout: installtoolsall # DO NOT MODIFY. Always true for tool install ar

The [Arm Performance Libraries](https://developer.arm.com/downloads/-/arm-performance-libraries#documentation) provide developers with optimized math libraries for high performance computing applications on Arm Neoverse based hardware.

These libraries include highly optimized functions for BLAS, LAPACK, FFT, sparse linear algebra, libamath and libastring.
These libraries are free to use and do not require a license. They can be installed either standalone or with your installation of [Arm Compiler for Linux](/install-guides/acfl). This install guide covers the standalone installation.
These libraries include highly optimized functions for BLAS, LAPACK, FFT, sparse linear algebra, libamath and libastring.
These libraries are free to use and do not require a license. They can be installed either standalone or with your installation of [Arm Compiler for Linux](/install-guides/acfl). This install guide covers the standalone installation.

Arm Performance Libraries are available for use on [Windows 11 on Arm](#windows), [macOS](#macos) (Apple Silicon), and [Linux](#linux) (AArch64) hosts.

Below are the official documentation references:

- Reference Guide:  [Arm Performance Libraries Reference Guide](https://developer.arm.com/documentation/101004/latest)
- Windows:     [Get started with Arm Performance Libraries (Windows version)](https://developer.arm.com/documentation/109361/2310/?lang=en)
- MacOS:        [Get started with Arm Performance Libraries (macOS version)](https://developer.arm.com/documentation/109362/2310/?lang=en)
- Linux:         [Get started with Arm Performance Libraries (stand-alone Linux version)](https://developer.arm.com/documentation/102620/2310/?lang=en)

## Windows {#windows}

On your Windows 11 Arm machine, go to the [Arm Performance Libraries download page](https://developer.arm.com/downloads/-/arm-performance-libraries). Click on the Download Windows section. You will be prompted to review and accept the End User License Agreement before you can download the zip file. Click on the `I accept the terms of this License Agreement` checkbox and proceed to `Download` as shown below.

![win_download #center](/install-guides/_images/download-win-armpl.png)
Open your Windows File Explorer and locate the downloaded `arm-performance-libraries_23.08.zip` file.
![win_download #center](/install-guides/_images/download-win-armpl_23.10.png)

Open your Windows File Explorer and locate the downloaded `arm-performance-libraries_23.10.zip` file.
Extract the contents of this zip file using the "Extract all" button at the top of the Windows File Explorer.

### Update your system environment variables

Using Windows Search, open `Edit the System Variables` in the `Control Panel`.
On the `Advanced Tab` of the `System Properties` window, click on the `Environment Variables` button.
On the `Advanced Tab` of the `System Properties` window, click on the `Environment Variables` button.

![sys_prop #center](/install-guides/_images/windows-sys-prop.png)

Add a New variable called `ARMPL_DIR` which should point to the location where you unpacked the Arm Performance Libraries.

![add_var #center](/install-guides/_images/windows-sys-env.png)
![add_var #center](/install-guides/_images/windows-sys-env_23.10.png)

Edit the `Path` variable to add `%ARMPL_DIR%\bin` to the list of existing directories in your path.

![edit_path #center](/install-guides/_images/win-sys-path.png)

You can now start linking your application to the Arm Performance libraries on your Windows on Arm device. Follow the examples in the included `RELEASE_NOTES` file of your extracted installation directory to get started.

For more information refer to [Get started with Arm Performance Libraries (Windows version)
Version 23.10](https://developer.arm.com/documentation/109361/2310/?lang=en)

## macOS {#macos}

Go to the Download MacOS section of the [Arm Performance Libraries download page](https://developer.arm.com/downloads/-/arm-performance-libraries) and download the `dmg` file.
Double-click on the icon of the downloaded package to mount the disk image. Alternatively, open a terminal and run the command below:

```console
hdiutil attach armpl_23.06_flang-new_clang_16.dmg
hdiutil attach arm-performance-libraries_23.10_macOS.dmg
```

Now run the installation script as a superuser:

```console
/Volumes/armpl_23.06_flang-new_clang_16_installer/armpl_23.06_flang-new_clang_16_install.sh -y
/Volumes/arm-performance-libraries_23.10_macOS/arm-performance-libraries_23.10_macOS_install.sh -y
```
Using this command you automatically accept the End User License Agreement and the packages are installed to the `/opt/arm` directory. If you want to change the installation directory location use the `--install_dir` option with the script and provide the desired directory location.

To get started, compile and test the examples included in the `/opt/arm/<armpl_dir>/examples/`, or `<install_dir>/<armpl_dir>/examples/` directory, if you have installed to a different location than the default.

For more information refer to [Get started with Arm Performance Libraries (macOS version)
Version 23.10](https://developer.arm.com/documentation/109362/2310/?lang=en)

## Linux {#linux}

Arm Performance Libraries are supported on most Linux Distributions like Ubuntu, RHEL, SLES and Amazon Linux on an `AArch64` host and compatible with various versions of GCC.

[Download](https://developer.arm.com/downloads/-/arm-performance-libraries) the appropriate package for your Linux distribution and version of GCC from the Download Linux section.

The instructions shown below are for an Ubuntu 22.04 AArch64 Linux Host with GCC version 11.3 installed.
The instructions shown below are for an Ubuntu 22.04 AArch64 Linux Host with GCC version 12.2 installed.

On a terminal, run the command shown below to download the appropriate package:
```command
wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-performance-libraries/23-04-1/ubuntu-22/arm-performance-libraries_23.04.1_Ubuntu-22.04_gcc-11.3.tar
wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-performance-libraries/23-10/ubuntu-22/arm-performance-libraries_23.10_Ubuntu-22.04_gcc-12.2.tar
```

Use `tar` to extract the file and then change directory:

```command
tar -xf arm-performance-libraries_23.04.1_Ubuntu-22.04_gcc-11.3.tar
cd arm-performance-libraries_23.04.1_Ubuntu-22.04/
tar -xf arm-performance-libraries_23.10_Ubuntu-22.04_gcc-12.2.tar
cd arm-performance-libraries_23.10_Ubuntu-22.04/
```
Run the installation script as a super user:

```command
sudo ./arm-performance-libraries_23.04.1_Ubuntu-22.04.sh -a
sudo ./arm-performance-libraries_23.10_Ubuntu-22.04.sh -a
```
Using the `-a` switch you automatically accept the End User License Agreement and the packages are installed to the `/opt/arm` directory. If you want to change the installation directory location use the `--install-to` option with the script and provide the desired directory location.

Expand All @@ -112,6 +124,12 @@ Install environment modules on your machine:
sudo apt install environment-modules
```

Set your bash environment to use modules:

```command
source /usr/share/modules/init/bash
```

Set the `MODULEPATH` environment variable to point to the location of the installed modulefiles for Arm Performance Libraries:

```command
Expand All @@ -127,13 +145,16 @@ module avail
The output should be similar to:

```output
armpl/23.04.1_gcc-11.3
armpl/23.10.0_gcc-12.2
```

Load the appropriate module:

```command
module load armpl/23.04.1_gcc-11.3
module load armpl/23.10.0_gcc-12.2
```
You can now compile and test the examples included in the `/opt/arm/<armpl_dir>/examples/`, or `<install_dir>/<armpl_dir>/examples/` directory, if you have installed to a different location than the default.
You can now compile and test the examples included in the `/opt/arm/<armpl_dir>/examples/`, or `<install_dir>/<armpl_dir>/examples/` directory, if you have installed to a different location than the default.

For more information refer to [Get started with Arm Performance Libraries (stand-alone Linux version)
Version 23.10](https://developer.arm.com/documentation/102620/2310/?lang=en)

Loading

0 comments on commit 43b659b

Please sign in to comment.