added note for demo build (#18)

iakov · Dec 25, 2023 · 9bd957e · 9bd957e
1 parent c42f52c
commit 9bd957e
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/LFD112x-RU/Chapters/Chapter5.adoc b/LFD112x-RU/Chapters/Chapter5.adoc
@@ -287,6 +287,22 @@ export PATH=<путь до тулчейна>/bin:$PATH
 make
 ----
 
+[NOTE]
+.Примечание переводчика
+====
+При сборке может возникнуть ошибка `unrecognized opcode`.
+Это происходит из-за того, что в `Makefile` указаны флаги компилятора и компоновщика `-march=rv32imac`,
+задающие архитектуру набора команд `rv32imac` со стандартными расширениями.
+Однако используемые в демо инструкции `csrc` и `csrw` являются частью расширения `Zicsr`,
+вынесенного из базовой ISA версии выше `2.2`.
+И для `gcc` версии `11.1.0` и выше необходимо отдельно указывать расширение `Zicsr`.
+То есть необходимо в `Makefile` заменить все вхождения `-march=rv32imac` на `-march=rv32ima_zicsr`.
+
+Также возможна ошибка компиляции из-за неопределенной константы `configCLINT_BASE_ADDRESS`.
+В таком случае необходимо определить её в файле `FreeRTOSConfig.h`,
+добавив после директив `#include` строку `#define configCLINT_BASE_ADDRESS CLINT_ADDR`.
+====
+
 .Запуск примера
 [source,shell]
 ----