Changelog
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 notAdd 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 librarynmsis_nn
library no longer select dsp library, since now it can live without dsp library
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
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
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
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
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 LibraryAdd tp register initialization and add early exception setup during startup in
startup_<Device>.S
Adding support for Nuclei C Runtime library
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
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.2Rename
RISCV_VECTOR
toRISCV_MATH_VECTOR
Fix FLEN and XLEN mis-usage in library
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>
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
V1.0.2-RC2
This is the release candidate version V1.0.2-RC2
release of Nuclei MCU Software Interface Standard(NMSIS).
The following changes has been made since V1.0.2-RC1
.
Documentation
Update NMSIS Core/DSP/NN related documentation
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>
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
V1.0.1
This is the official V1.0.1
release of Nuclei MCU Software Interface Standard(NMSIS).
The following changes has been maded since V1.0.1-RC1
.
Device Templates
I/D Cache enable assemble code in startup_<Device>.S are removed now
Cache control updates in System_<Device>.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>
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
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 templatesModifications 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
V1.0.0-beta1
Main changes in release V1.0.0-beta1.
NMSIS-Core
Fix
SysTick_Reload
implementationUpdate
ECLIC_Register_IRQ
implementation to allow handler == NULLFix
MTH
offset from 0x8 to 0xB, this will affect function ofECLIC_GetMth
andECLIC_SetMth
Fix wrong macro check in cache function
Add missing
SOC_INT_MAX
enum definition in Device templateIn
System_<Device>.c
, ECLIC NLBits set to__ECLIC_INTCTLBITS
, which means all the bits are for level, no bits for priority
V1.0.0-beta
Main changes in release V1.0.0-beta.
NMSIS-Core
Fix error typedef of
CSR_MCAUSE_Type
Change
CSR_MCACHE_CTL_DE
to future value0x00010000
Fix names in CSR naming,
CSR_SCRATCHCSW
->CSR_MSCRATCHCSW
, andCSR_SCRATCHCSWL
->CSR_MSCRATCHCSWL
Add macros in
riscv_encoding.h
:MSTATUS_FS_INITIAL
,MSTATUS_FS_CLEAN
,MSTATUS_FS_DIRTY
Documentation
Fix an typo in core_template_intexc.rst
Add cross references of Nuclei ISA Spec
Update appendix
Refines tables and figures
V1.0.0-alpha.1
API changes has been maded to system timer.
Start from Nuclei N core version 1.4, MSTOP register is renamed to MTIMECTL to provide more features
Changes made to NMSIS/Core/core_feature_timer.h
MSTOP register name changed to MTIMECTL due to core spec changes
SysTimer_SetMstopValue renamed to SysTimer_SetControlValue
SysTimer_GetMstopValue renamed to SysTimer_GetControlValue
Add SysTimer_Start and SysTimer_Stop to start or stop system timer counter
SysTick_Reload function is introduced to reload system timer
Macro names started with SysTimer_xxx are changed, please check in the code.
Removed unused lines of code in DSP and NN library source code which has unused macros which will not work for RISCV cores.
Fix some documentation issues, mainly typos and invalid cross references.
V1.0.0-alpha
This is the V1.0.0-alpha
release of Nuclei MCU Software Interface Standard(NMSIS).
In this release, we have release three main compoments:
NMSIS-Core: Standardized API for the Nuclei processor core and peripherals.
NMSIS-DSP: DSP library collection optimized for the Nuclei Processors which has RISC-V SIMD instruction set.
NMSIS-NN: Efficient neural network library developed to maximize the performance and minimize the memory footprint Nuclei Processors which has RISC-V SIMD instruction set.
We also released totally new Nuclei-SDK which is an SDK implementation based on the NMSIS-Core for Nuclei N/NX evaluation cores running on HummingBird Evaluation Kit.