Releases: Nuclei-Software/NMSIS
Nuclei Microcontroller Software Interface Standard V1.2.1
This is the version 1.2.1 release.
-
NMSIS-Core
- Fix and update many CSR type define structure defined in
core_feature_base.h
- Fix protection type error in PMP/sPMP
__set_PMPENTRYx/__set_sPMPENTRYx
API - Add SMPU support in
core_feature_spmp.h
- Fix wrong CLIC macros defined in
core_feature_eclic.h
- Update RISC-V DSP intrinsic API and its comments
- Fix and update many CSR type define structure defined in
-
NMSIS-DSP
- Sync with CMSIS-DSP library(CMSIS-DSP v1.15.0, commit id:8f8bb8d5)
- Add a few Nuclei DSP N2 intrinsic APIs in
core_feature_dsp.h
, they are:__RV_DPACK32
,__RV_DSUNPKD810
,__RV_DSUNPKD820
,
__RV_DSUNPKD830
,__RV_DSUNPKD831
,__RV_DSUNPKD832
,__RV_DZUNPKD810
,__RV_DZUNPKD820
,__RV_DZUNPKD830
,
__RV_DZUNPKD831
,__RV_DZUNPKD832
. And change__RV_DPKBB32
to__RV_DPACK32
for better performance - Unified instruction naming style in
core_feature_dsp.h
, such as: changeDSMMULU
toDSMMUL.u
, changeDKWMMULU
toDKWMMUL.u
,
changeDKMMACU
toDKMMAC.u
, changeDKMMSBU
toDKMMSB.u
, changeDSMAQASU
toDSMAQA.SU
, changeDDSMAQASU
toDDSMAQA.SU
- Optimize the rvv implementation of some MatMult and Complex MatMult functions
- Fixed some doc erros in
core_feature_dsp.h
- Fixed
riscv_lms_q31.c
rvv bug
-
NMSIS-NN
- Sync with CMSIS-NN library(CMSIS-NN v5.0.0, commit id:bfc54edb)
- Optimize some functions with Nuclei DSP N3 instruction(such as: riscv_convolve_s8, riscv_fully_connected_s8, etc.)
- Optimize the rvv implementation of fullyconnect s8 function
- Fixed
riscv_nn_softmax_common_s8.c
rvv bug
-
CI
- Nuclei SDK use 0.6.0 release version, SOC still use evalsoc.
-
Documentation
- Update sphinx and doxygen document version to 1.2.1
Full Changelog: 1.2.0...1.2.1
Nuclei Microcontroller Software Interface Standard V1.2.0
This is the version V1.2.0
release.
This 1.2.0 version will no longer support old gcc 10 verison, and it now only support Nuclei Toolchain 2023.10
(gcc13 and clang17) or later. The major changes that can be felt are as follows:The prefix of toolchain has changed from
riscv-nuclei-elf-
toriscv64-unknown-elf-
The
-march
option has changed a lot, see riscv-non-isa/riscv-toolchain-conventions#26, for examples:
b
extension changed to_zba_zbb_zbc_zbs
extension,p
extension changed to_xxldsp
,_xxldspn1x
,_xxldspn2x
,_xxldspn3x
extensions which means
stardard DSP extension, Nuclei N1, N2, N3 DSP extensionsv
extension changed tov
,_zve32f
,_zve64f
extensionsThese extensions also can be combined in a certain order, please be cautious
The name of Libraries has changed with
-march
, for examples, the library namedlibnmsis_dsp_rv32imacb.a
is now named
libnmsis_dsp_rv32imac_zba_zbb_zbc_zbs.a
sinceb
extension changed to_zba_zbb_zbc_zbs
NMSIS v1.2.0 should be used with Nuclei SDK v0.5.0 or later
RVV intrinsic APIs is update to v0.12.0, please visit
rvv-intrinsic-doc <https://github.com/riscv-non-isa/rvv-intrinsic-doc/releases/tag/v0.12.0>
_
Please create issue if you are facing issues using NMSIS, see https://github.com/Nuclei-Software/NMSIS/issues
-
NMSIS-Core
- Add more Nuclei DSP N1/N2/N3 intrinsic APIs and fix some intrinsic API definition and descriptions in
core_feature_dsp.h
- Add basic IAR support for NMSIS Core header files and device template, for sample usage, see Nuclei SDK 0.5.0 release
- Fix missing break in
__set_hpm_event
function API in core_feature_base.h, which affected the nmsis_bench.h - Use IAR custom instruction and IAR P-ext 0.5.0 support to support Nuclei DSP extension based on P-ext 0.5.4, see changes maded in
core_feature_dsp.h
, only Xxldsp is supported, no N1/N2/N3 supported, and some instructions can't be supported using custom instruction, but in future, we will cooperate with IAR to do full Nuclei DSP support - Add more CSRs definition according to Nuclei ISA updates such as Zc/stack check
- No more bitmanip extension intrinsic header <rvintrin.h> for gcc13
- Fix __RV_CLAMP macro and add __MACHINE/SUPERVISOR/USER_INTERRUPT macros
- Add __get_hart_index and SysTimer_GetHartID and modify __get_hart_id API
- In <Device.h>, we introduced __HARTID_OFFSET and __SYSTIMER_HARTID macro to represent timer hart index relation with cpu hartid for AMP SoC
- Clean compiler warning of NMSIS-Core header files
- Fix Cache CCM API missing return value in some case
- Add more Nuclei DSP N1/N2/N3 intrinsic APIs and fix some intrinsic API definition and descriptions in
-
NMSIS-DSP
- Defined
NUCLEI_DSP_DEFAULT
,NUCLEI_DSP_N1
,NUCLEI_DSP_N2
,NUCLEI_DSP_N3
inriscv_math_types.h
according to gcc options. This means that if compile with--march=rv32imafc_xxldspn1x
, theNUCLEI_DSP_N1
will defined,
if compile with--march=rv32imafc_xxldspn2x
, theNUCLEI_DSP_N1
andNUCLEI_DSP_N2
will defined, and so on - Optimize some functions with DSP N1/N2/N3 (such as FilteringFunctions, TransformFunctions, ComplexMathFunctions)
- RVV intrinsic APIs is update to v0.12.0
- Add f16 support(include f16 rvv extension support)
- Fix the use of expd80 instruction(Nuclei default dsp instruction)
- Fix some testcases bugs(such as MatrixFunctions, TransformFunctions)
- Defined
-
NMSIS-NN
- Defined
NUCLEI_DSP_DEFAULT
,NUCLEI_DSP_N1
,NUCLEI_DSP_N2
,NUCLEI_DSP_N3
inriscv_nn_math_types.h
according to gcc options - RVV intrinsic APIs is update to v0.12.0
- Clean code(nnref lib)
- Defined
-
Build System
- Toolchain change to gcc13, The prefix of toolchain has changed to
riscv64-unknown-elf-
, old gcc10riscv-nuclei-elf-gcc
changed to gcc 13riscv64-unknown-elf-gcc
- Add ci configurations to support different instruction combinations, please check
Scripts/Build/nmsis_dsp.json
andScripts/Build/nmsis_nn.json
- Library naming scheme changed due to march changes, which means the library name will not be compatiable with previous release, check dsp/nn get started guide for details
- F16 library build is supported now when zfh/zvfh extension enabled
- Toolchain change to gcc13, The prefix of toolchain has changed to
-
CI
- Change NMSIS to use Nuclei SDK evalsoc as ci run target, demosoc is removed in 0.5.0 Nuclei SDK release.
- Spilt DSP and NN test jobs to reduce ci running time
- Build DSP/NN library in one job now, since N1/N2/N3 library naming are different, and library build speed for risc-v vector increased now
Full Changelog: 1.1.1...1.2.0
Nuclei Microcontroller Software Interface Standard V1.1.1
This is the version V1.1.1
release.
-
NMSIS-Core
-
Add CIDU support via core_feature_cidu.h, and
__CIDU_PRESENT
macro is required in<Device>.h
to represent CIDU present or not -
Add macros of HPM m/s/u event enable, events type, events idx
-
Fix define error of HPM_INIT macro
-
Update systimer/pmp/spmp/eclic API comment and implementation
-
Add Cache ECC related APIs
-
Due to mhartid csr update, two new API added called
__get_hart_id
and__get_cluster_id
- mhartid in Nuclei RISC-V processor are now used to present cluster id and hart id
- bit 0-7 is used for hart id in current cluster
- bit 8-15 is used for cluster id of current cluster
-
-
NMSIS-DSP
- Sync with CMSIS-DSP library(branch:main, commit id:1d9e38a, after CMSIS-DSP v1.14.4)
- Optimize some functions with RVV(such as: ComplexMathFunctions, FilteringFunctions, MatrixFunctions, StatisticsFunctions, etc.)
- Some bugfix(riscv_mat_inverse_f32.c rvv fix, riscv_offset_q15.c p fix, riscv_fir_q15.c rvv fix etc.)
-
NMSIS-NN
- Sync with CMSIS-NN library(branch:main, commit id:61d1bb6, CMSIS-NN v4.1.0)
- Compile independent, no longer depend on NMSIS-DSP
- Optimize some functions with RVV(such as: ActivationFunctions, FullyConnectedFunctions, PoolingFunctions, etc.)
- Some bugfix that make tflite-micro test successfully
-
Documentation
- Update sphinx and doxygen document version to 1.1.1
- Use mathjax to render latex formulas instead of latex, which can avoid strange compile error
- Change dsp/nn sphinx rst document structure to match dsp/nn doxygen documentation update
-
NPK
- Add
nmsis_dsp_nn
choice fornmsislibsel
, it will select nmsis dsp and nn library nmsis_nn
library no longer select dsp library, since now it can live without dsp library
- Add
Full Changelog: 1.1.0...1.1.1
Nuclei Microcontroller Software Interface Standard V1.1.0
This is the version V1.1.0
release of Nuclei MCU Software Interface Standard(NMSIS).
-
NMSIS-Core
- Add
nmsis_bench.h
for benchmark and hpm helper functions. - Add hpm related API
- Update
riscv_encoding.h
for latest riscv changes. - Add
core_feature_spmp.h
for TEE/sPMP unit. - Add more Nuclei DSP N1/N2/N3 intrinsic APIs in
core_feature_dsp.h
- Bring SMP/AMP support in
core_feature_eclic.h
andcore_feature_timer.h
- Add
-
NMSIS-DSP
- Sync with DSP library in CMSIS 5.9.0 release.
- Add experimental RV32 Vector support.
- Optimize with RVP/RVV for DSP library.
-
NMSIS-NN
- Sync with NN library in CMSIS 5.9.0 release.
- Add experimental RV32 Vector support.
- Optimize with RVP/RVV for NN library.
-
Build System
- DSP64 is removed, and replaced by NUCLEI_DSP_N1, which means Nuclei DSP N1 extension present.
- NUCLEI_DSP_N2 and NUCLEI_DSP_N3 are introduced to standard for Nuclei DSP N2/N3 extension present.
- Now you build different DSP/NN library optimized Nuclei DSP N1/N2/N3 via command such as
make NUCLEI_DSP=N1 gen
- Add
nmsis_help
make target to show help message to build nmsis dsp/nn library. - Add
check_build
andcheck_run
make target for locally build or run on a small test suite configuration. - Add fpga related test script located in
Scripts/Configs/fpga/
. - Fix bugs found in
nlbuild.py
script.
-
Device Tempates
- Update Device templates to support SMP/AMP and new linker script changes to align with Nuclei SDK 0.4.0
-
CI
- Misc changes for github and gitlab ci, see commit history
- gitlab ci will now test
NUCLEI_DSP=NO/N1/N2/N3
cases and also check rv32 with VPU for DSP/NN test cases
-
Documentation
- Update Core/DSP/NN documentation
-
Misc
- Nuclei SDK 0.4.0 will use NMSIS 1.1.0
Full Changelog: 1.0.4...1.1.0
Nuclei Microcontroller Software Interface Standard V1.0.4
This is the version V1.0.4
release of Nuclei MCU Software Interface Standard(NMSIS).
-
NMSIS-Core
- add
__CCM_PRESENT
macro in NMSIS-Core, if CCM hardware unit is present in your CPU,
__CCM_PRESENT
macro need to be set to 1 in<Device>.h
- Fixed mtvec related api comment in
core_feature_eclic.h
- Add safely write mtime/mtimecmp register for 32bit risc-v processor
- rearrage #include header files for all NMSIS Core header files
- removed some not good #pragma gcc diagnostic lines in
nmsis_gcc.h
- add
-
NMSIS-DSP
- Add initial bitmainp extension support
- Fix bug in riscv_cmplx_mult_cmplx_q15 function when XLEN=64
-
NMSIS-NN
- Add initial bitmainp extension support
- Change riscv_maxpool_q7_HWC implementation for rvv
- Re-org NN_Lib_Tests to Tests
-
Build System
- Change minimal version of cmake to 3.14
- Add REBUILD=0 to reuse previous generated Makefile
-
Device Tempates
- Fix bss section lma and vma not aligned and tbss space not reserved
-
CI
- Change NMSIS to use Nuclei SDK demosoc as ci run target
- only run ci on master/develop branch
-
Documentation
- Update get started guide for dsp/nn library
Nuclei Microcontroller Software Interface Standard V1.0.3
This is the official release version V1.0.3
release of Nuclei MCU Software Interface Standard(NMSIS).
This release is only supported by Nuclei GNU Toolchain 2022.01 and its later version,
since it required intrinsic header files in RISC-V GCC for B/P/V extensions.
The following changes has been made since V1.0.2
.
-
Documentation
- Update NMSIS Core/DSP/NN related documentation
-
Device Templates
- Add
__INC_INTRINSIC_API
,__BITMANIP_PRESENT
and__VECTOR_PRESENT
in<Device>.h
- Add more REG/ADDR/BIT access macros in
<Device>.h
- Update linker script for
<Device>.ld
for Nuclei C Runtime Library - Add tp register initialization and add early exception setup during startup in
startup_<Device>.S
- Adding support for Nuclei C Runtime library
- Add
-
NMSIS-Core
- Update
core_feature_eclic.h
,core_feature_timer.h
andcore_feature_dsp.h
- Added
core_feature_vector.h
andcore_feature_bitmainp.h
- Add more nuclei customized csr in
riscv_encoding.h
- Include rvb/rvp/rvv header files when __INC_INTRINSIC_API = 1
- Update
-
NMSIS-DSP/NN
- Add support for Nuclei GNU Toolchain 2021.12
- Add new build system to generate NMSIS DSP and NN library
- Update cmake files for both DSP and NN library
- No need to define
__RISCV_FEATURE_DSP
and__RISCV_FEATURE_VECTOR
when using DSP or NN library,
it will be defined inriscv_math_types.h
via the predefined macros in Nuclei RISC-V gcc 10.2 - Rename
RISCV_VECTOR
toRISCV_MATH_VECTOR
- Fix FLEN and XLEN mis-usage in library
Nuclei Microcontroller Software Interface Standard V1.0.2
This is the official release version V1.0.2
release of Nuclei MCU Software Interface Standard(NMSIS).
The following changes has been made since V1.0.1
.
-
Documentation
- Update NMSIS Core/DSP/NN related documentation
-
Device Templates
- DOWNLOAD_MODE_xxx macros are removed from riscv_encoding.h, it is now defined as enum in
<Device.h>
, and
can be customized by soc vendor. - startup code now don't rely on DOWNLOAD_MODE macro, instead it now rely on a new macro called VECTOR_TABLE_REMAPPED,
when VECTOR_TABLE_REMAPPED is defined, it means the vector table's lma != vma, such as vector table need to be
copied from flash to ilm when boot up - Add more customized csr of Nuclei RISC-V Core
- Add BIT, BITS, REG, ADDR related macros in
<Device.h>
- DOWNLOAD_MODE_xxx macros are removed from riscv_encoding.h, it is now defined as enum in
-
NMSIS-Core
- Nuclei Cache CCM operation APIs are now introduced in core_feature_cache.h
- Update NMSIS-Core header files
-
NMSIS-DSP/NN
- Merged the official CMSIS 5.8.0 release, CMSIS-DSP 1.9.0, CMSIS-NN 3.0.0
- RISC-V Vector extension and P-extension support for DSP/NN libraries are added
Nuclei Microcontroller Software Interface Standard V1.0.2-RC1
This is the release candidate version V1.0.2-RC1
release of Nuclei MCU Software Interface Standard(NMSIS).
The following changes has been made since V1.0.1
.
-
Device Templates
- DOWNLOAD_MODE_xxx macros are removed from riscv_encoding.h, it is now defined as enum in
<Device.h>
, and
can be customized by soc vendor. - startup code now don't rely on DOWNLOAD_MODE macro, instead it now rely on a new macro called VECTOR_TABLE_REMAPPED,
when VECTOR_TABLE_REMAPPED is defined, it means the vector table's lma != vma, such as vector table need to be
copied from flash to ilm when boot up - Add BIT, BITS, REG, ADDR related macros in
<Device.h>
- DOWNLOAD_MODE_xxx macros are removed from riscv_encoding.h, it is now defined as enum in
-
NMSIS-Core
- Nuclei Cache CCM operation APIs are now introduced in core_feature_cache.h
-
NMSIS-DSP/NN
- Merged the official CMSIS 5.8.0 release, CMSIS-DSP 1.9.0, CMSIS-NN 3.0.0
- RISC-V Vector extension and P-extension support for DSP/NN libraries are added
Nuclei Microcontroller Software Interface Standard V1.0.1
This is the offical V1.0.1
release of Nuclei MCU Software Interface Standard(NMSIS).
-
NMSIS-Core
- Add RISC-V DSP 64bit intrinsic functions in
core_feature_dsp.h
- Add more CSR definitions in
riscv_encoding.h
- Update arm compatiable functions for RISC-V dsp instruction cases in
core_compatiable.h
- Add RISC-V DSP 64bit intrinsic functions in
-
NMSIS-DSP
- Optimize RISC-V 32bit DSP library implementation
- Add support for Nuclei RISC-V 64bit DSP SIMD instruction for DSP library
- Add test cases used for DSP library testing, mainly for internal usage
- Change the examples and tests to use Nuclei SDK as running environment
-
NMSIS-NN
- Add support for Nuclei RISC-V 64bit DSP SIMD instruction for NN library
- Change the examples and tests to use Nuclei SDK as running environment
-
Device Templates
-
Add
DDR
DOWNLOAD_MODE in device templates -
Modifications to
startup_<Device>.S
files_premain_init
is added to replace_init
_postmain_fini
is added to replace_fini
-
If you have implemented your init or de-init functions through
_init
or_fini
,
please use_premain_init
and_postmain_fini
functions definedsystem_<Device>.c
now -
Cache control updates in System_.c
- I-Cache will be enabled if
__ICACHE_PRESENT = 1
defined in<Device>.h
- D-Cache will be enabled if
__DCACHE_PRESENT = 1
defined in<Device>.h
- I-Cache will be enabled if
-
Nuclei Microcontroller Software Interface Standard V1.0.1-RC1
This is release candidate version V1.0.1-RC1
of NMSIS.
-
NMSIS-Core
- Add RISC-V DSP 64bit intrinsic functions in
core_feature_dsp.h
- Add more CSR definitions in
riscv_encoding.h
- Update arm compatiable functions for RISC-V dsp instruction cases in
core_compatiable.h
- Add RISC-V DSP 64bit intrinsic functions in
-
NMSIS-DSP
- Optimize RISC-V 32bit DSP library implementation
- Add support for Nuclei RISC-V 64bit DSP SIMD instruction for DSP library
- Add test cases used for DSP library testing, mainly for internal usage
- Change the examples and tests to use Nuclei SDK as running environment
-
NMSIS-NN
- Add support for Nuclei RISC-V 64bit DSP SIMD instruction for NN library
- Change the examples and tests to use Nuclei SDK as running environment
-
Device Templates
- Add
DDR DOWNLOAD_MODE
in device templates - Modifications to ``startup_.S** files
_premain_init
is added to replace_init
_postmain_fini
is added to replace_fini
- I/D Cache will be enabled by default now if present
- If you have implemented your functions in
_init
or_fini
,
please place the changes in functions definedsystem_<Device>.c
- Add