summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKshitij Sisodia <kshitij.sisodia@arm.com>2022-12-22 16:51:23 +0000
committerRichard <richard.burton@arm.com>2022-12-23 16:19:04 +0000
commit657a54dc7bf8c901a5cf009606d179fe9ae8fd68 (patch)
tree28ec712ca5a6e7cdfebb89749b3ca5fb402dd7a6 /docs
parentde54e1606b21d333e126525807414455d2ff1840 (diff)
downloadml-embedded-evaluation-kit-657a54dc7bf8c901a5cf009606d179fe9ae8fd68.tar.gz
MLECO-3748: Documentation updates
Added documentation around known issue with Arm GNU toolchain version 12.2.1. Minor change for MLECO-3731 also included. Link-time warnings for Arm GNU toolchain 11.3.1 also fixed. Change-Id: Ia8215e9f71327eeb59868aea91729d7b19dd6d34 Signed-off-by: Kshitij Sisodia <kshitij.sisodia@arm.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/sections/building.md7
-rw-r--r--docs/sections/troubleshooting.md28
2 files changed, 33 insertions, 2 deletions
diff --git a/docs/sections/building.md b/docs/sections/building.md
index 1489343..a7a894a 100644
--- a/docs/sections/building.md
+++ b/docs/sections/building.md
@@ -35,7 +35,12 @@ This section assumes that you are using an **x86_64 Linux** build machine.
Before proceeding, it is *essential* to ensure that the following prerequisites have been fulfilled:
- GNU Arm embedded toolchain 10.2.1 (or higher) or the Arm Compiler version 6.16, or higher, is installed and available
- on the path. Test the compiler by running:
+ on the path.
+
+> **Note**: There is a known issue with Arm GNU Embedded Toolchain version 12.2.Rel1. See
+> [Internal Compiler Error](./troubleshooting.md#internal-compiler-error) for details.
+
+ Test the compiler by running:
```commandline
armclang -v
diff --git a/docs/sections/troubleshooting.md b/docs/sections/troubleshooting.md
index d5224c4..0b6f4f9 100644
--- a/docs/sections/troubleshooting.md
+++ b/docs/sections/troubleshooting.md
@@ -9,6 +9,7 @@
- [No matching distribution found for ethos-u-vela==3.5.0](./troubleshooting.md#no-matching-distribution-found-for-ethos_u_vela)
- [How to update Python3 package to 3.7 version](./troubleshooting.md#how-to-update-python3-package-to-newer-version)
- [Error trying to build on Arm Virtual Hardware](./troubleshooting.md#error-trying-to-build-on-arm-virtual-hardware)
+ - [Internal Compiler Error](./troubleshooting.md#internal-compiler-error)
## Inference results are incorrect for my custom files
@@ -247,4 +248,29 @@ You can then try rebuilding again e.g.
```commandline
python3 ./build_default.py
```
-and the error should be fixed. \ No newline at end of file
+and the error should be fixed.
+
+## Internal Compiler Error
+
+There is a known issue with the Arm GNU toolchain version 12.2 (release December 22, 2022).
+Compiler from this toolchain throws up this error:
+
+```
+during RTL pass: combine
+/home/user/ml-embedded-evaluation-kit/dependencies/cmsis-nn/Source/SoftmaxFunctions/arm_softmax_s8.c: In function 'arm_exp_on_negative_values_mve_32x4':
+/home/user/ml-embedded-evaluation-kit/dependencies/cmsis-nn/Source/SoftmaxFunctions/arm_softmax_s8.c:74:1: internal compiler error: in trunc_int_for_mode, at explow.cc:59
+ 74 | }
+ | ^
+0x7f0343d9b082 __libc_start_main
+ ../csu/libc-start.c:308
+Please submit a full bug report, with preprocessed source (by using -freport-bug).
+Please include the complete backtrace with any bug report.
+See <https://bugs.linaro.org/> for instructions.
+```
+
+This is expected to be fixed in the next release of the toolchain. We recommend using the previous version 11.3.Rel1
+(from August 2022).
+
+See
+- [GCC patches: PR107987](https://gcc.gnu.org/pipermail/gcc-patches/2022-December/607963.html)
+- [CMSIS-NN issue 13](https://github.com/ARM-software/CMSIS-NN/issues/13)