From 117e17eb144cf42a3f685e9327f5e7a0c94545f2 Mon Sep 17 00:00:00 2001 From: Jakub Sujak Date: Tue, 21 Feb 2023 10:52:57 +0000 Subject: =?UTF-8?q?Add=20Microsoft=20Windows=C2=AE=20trademarks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Jakub Sujak Change-Id: Ie2332d197f274f6f44fa71093f4aff83e91c2a20 Signed-off-by: Jakub Sujak Reviewed-on: https://review.mlplatform.org/c/ml/ComputeLibrary/+/9182 Reviewed-by: Gunes Bayir Comments-Addressed: Arm Jenkins Benchmark: Arm Jenkins Tested-by: Arm Jenkins --- README.md | 1 + docs/user_guide/how_to_build_and_run_examples.dox | 26 +++++++++++----------- docs/user_guide/release_version_and_change_log.dox | 2 +- 3 files changed, 15 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index fee9eafe8d..9500f05b08 100644 --- a/README.md +++ b/README.md @@ -176,3 +176,4 @@ countries. Tizen is a registered trademark of The Linux Foundation. +Windows® is a trademark of the Microsoft group of companies. diff --git a/docs/user_guide/how_to_build_and_run_examples.dox b/docs/user_guide/how_to_build_and_run_examples.dox index 2f61f938a3..ab87989925 100644 --- a/docs/user_guide/how_to_build_and_run_examples.dox +++ b/docs/user_guide/how_to_build_and_run_examples.dox @@ -320,24 +320,24 @@ To cross-compile the library with Arm® Neon™ support for baremetal armv8a: Examples are disabled when building for bare metal. If you want to build the examples you need to provide a custom bootcode depending on the target architecture and link against the compute library. More information about bare metal bootcode can be found here. -@section S1_6_windows_host Building on a Windows host system (cross-compile) +@section S1_6_windows_host Building on a Windows® host system (cross-compile) -Using `scons` directly from the Windows command line is known to cause +Using `scons` directly from the Windows® command line is known to cause problems. The reason seems to be that if `scons` is setup for cross-compilation -it gets confused about Windows style paths (using backslashes). Thus it is +it gets confused about Windows® style paths (using backslashes). Thus it is recommended to follow one of the options outlined below. -@subsection S1_6_1_ubuntu_on_windows Bash on Ubuntu on Windows (cross-compile) +@subsection S1_6_1_ubuntu_on_windows Bash on Ubuntu on Windows® (cross-compile) The best and easiest option is to use -Ubuntu on Windows. +Ubuntu on Windows®. This feature is still marked as *beta* and thus might not be available. However, if it is building the library is as simple as opening a *Bash on -Ubuntu on Windows* shell and following the general guidelines given above. +Ubuntu on Windows®* shell and following the general guidelines given above. @subsection S1_6_2_cygwin Cygwin (cross-compile) -If the Windows subsystem for Linux is not available Cygwin +If the Windows® subsystem for Linux is not available Cygwin can be used to install and run `scons`, the minimum Cygwin version must be 3.0.7 or later. In addition to the default packages installed by Cygwin `scons` has to be selected in the installer. (`git` might also be useful but is not strictly required if you already have got the source @@ -348,15 +348,15 @@ compiler is included in the Android standalone toolchain. After everything has been set up in the Cygwin terminal the general guide on building the library can be followed. -@subsection S1_6_3_WoA Windows on ARM (native build) +@subsection S1_6_3_WoA Windows® on Arm™ (native build) - Native builds on Windows are experimental and some features from the library interacting with the OS are missing. + Native builds on Windows® are experimental and some features from the library interacting with the OS are missing. -It's possible to build Compute Library natively on a windows system running on ARM. +It's possible to build Compute Library natively on a Windows® system running on Arm™. -Windows on ARM(WoA) systems provide compatibility emulating x86 binaries on aarch64. Unfortunately Visual Studio 2022 does not work on aarch64 systems because it's an x86_64bit application and these binaries cannot be exectuted on WoA yet. +Windows® on Arm™ (WoA) systems provide compatibility emulating x86 binaries on aarch64. Unfortunately Visual Studio 2022 does not work on aarch64 systems because it's an x86_64bit application and these binaries cannot be exectuted on WoA yet. -Because we cannot use Visual Studio to build Compute Library we have to set up a native standalone toolchain to compile C++ code for arm64 on Windows. +Because we cannot use Visual Studio to build Compute Library we have to set up a native standalone toolchain to compile C++ code for arm64 on Windows®. Native arm64 toolchain installation for WoA: - LLVM+Clang-12 which can be downloaded from: https://github.com/llvm/llvm-project/releases/download/llvmorg-12.0.0/LLVM-12.0.0-woa64.exe @@ -372,7 +372,7 @@ There are some additional tools we need to install to build Compute Library: - python 3 https://www.python.org/downloads/windows/ - scons can be installed with pip install scons -In order to use clang to build windows binaries natively we have to initialize the environment variables from VS22 correctly so that the compiler could find the arm64 C++ libraries. This can be done by pressing the key windows + r and running the command: +In order to use clang to build Windows® binaries natively we have to initialize the environment variables from VS22 correctly so that the compiler could find the arm64 C++ libraries. This can be done by pressing the key windows + r and running the command: cmd /k "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsx86_arm64.bat" diff --git a/docs/user_guide/release_version_and_change_log.dox b/docs/user_guide/release_version_and_change_log.dox index 8bb2a3f305..f592fdbc5e 100644 --- a/docs/user_guide/release_version_and_change_log.dox +++ b/docs/user_guide/release_version_and_change_log.dox @@ -104,7 +104,7 @@ v22.08 Public major release - Optimize Add layer by considering the input tensors as 1D array. - Add fixed-format BF16, FP16 and FP32 Neon™ GEMM kernels to support variable weights. - Add new winograd convolution kernels implementation and update the ACL \link arm_compute::cpu::CpuWinogradConv2d CpuWinogradConv2d\endlink operator. - - Add experimental support for native builds for Windows on Arm®. + - Add experimental support for native builds for Windows® on Arm™. - Build flag interpretation change: arch=armv8.6-a now translates to -march=armv8.6-a CXX flag instead of march=armv8.2-a + explicit selection of feature extensions. - Build flag change: toolchain_prefix, compiler_prefix: - Use empty string "" to suppress any prefixes. -- cgit v1.2.1