xmos · andrewstanfordjason · Jan 28, 2026 · Jan 28, 2026
diff --git a/doc/rst/src/reference/notes.h b/doc/rst/src/reference/notes.h
@@ -1,4 +1,4 @@
-// Copyright 2021-2024 XMOS LIMITED.
+// Copyright 2021-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 // This file exists as a compatibility work-around between vanilla Doxygen and

diff --git a/examples/app_bfp_demo/src/main.c b/examples/app_bfp_demo/src/main.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_fft_demo/src/main.c b/examples/app_fft_demo/src/main.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_filter_demo/src/filter_16bit_fir.c b/examples/app_filter_demo/src/filter_16bit_fir.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_filter_demo/src/filter_32bit_biquad.c b/examples/app_filter_demo/src/filter_32bit_biquad.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_filter_demo/src/filter_32bit_fir.c b/examples/app_filter_demo/src/filter_32bit_fir.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_filter_demo/src/main.c b/examples/app_filter_demo/src/main.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #include <stdio.h>

diff --git a/examples/app_vect_demo/src/main.c b/examples/app_vect_demo/src/main.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #include <stdio.h>

diff --git a/examples/app_vect_demo/src/vect_complex_s16_example.c b/examples/app_vect_demo/src/vect_complex_s16_example.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/examples/app_vect_demo/src/vect_s32_example.c b/examples/app_vect_demo/src/vect_s32_example.c
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 

diff --git a/lib_xcore_math/CMakeLists.txt b/lib_xcore_math/CMakeLists.txt
@@ -15,7 +15,8 @@ file( GLOB_RECURSE    SOURCES_C   "src/vect/*.c"
                                   "src/filter/*.c"
                                   "src/scalar/*.c" )
 file( GLOB_RECURSE    SOURCES_CPP "src/*.cpp" )
-file( GLOB_RECURSE    SOURCES_ASM "src/*.S"   )
+file( GLOB_RECURSE    SOURCES_ASM_XS3 "src/arch/xs3/*.S" )
+file( GLOB_RECURSE    SOURCES_ASM_VX4B "src/arch/vx4b/*.S" )
 file( GLOB_RECURSE    SOURCES_REF "src/arch/ref/*.c" )
 
 add_library( ${LIB_NAME}  STATIC )
@@ -24,7 +25,8 @@ target_sources( ${LIB_NAME}
   PRIVATE
     ${SOURCES_C}
     ${SOURCES_CPP}
-    $<$<PLATFORM_ID:XCORE_XS3A>:${SOURCES_ASM}>
+    $<$<PLATFORM_ID:XCORE_XS3A>:${SOURCES_ASM_XS3}>
+    $<$<PLATFORM_ID:XCORE_VX4B>:${SOURCES_ASM_VX4B}>
     $<$<PLATFORM_ID:Linux>:${SOURCES_REF}>
     $<$<PLATFORM_ID:Darwin>:${SOURCES_REF}>
     $<$<PLATFORM_ID:Windows>:${SOURCES_REF}>

diff --git a/lib_xcore_math/api/xcore_math.h b/lib_xcore_math/api/xcore_math.h
@@ -1,4 +1,4 @@
-// Copyright 2024 XMOS LIMITED.
+// Copyright 2024-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #ifndef _XCORE_MATH_H_

diff --git a/lib_xcore_math/api/xmath/_support/dct_impl.h b/lib_xcore_math/api/xmath/_support/dct_impl.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/_support/fft_impl.h b/lib_xcore_math/api/xmath/_support/fft_impl.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/api.h b/lib_xcore_math/api/xmath/api.h
@@ -1,4 +1,4 @@
-// Copyright 2021-2022 XMOS LIMITED.
+// Copyright 2021-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp.h b/lib_xcore_math/api/xmath/bfp/bfp.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp_complex_s16.h b/lib_xcore_math/api/xmath/bfp/bfp_complex_s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp_complex_s32.h b/lib_xcore_math/api/xmath/bfp/bfp_complex_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp_misc.h b/lib_xcore_math/api/xmath/bfp/bfp_misc.h
@@ -1,4 +1,4 @@
-// Copyright 2021-2022 XMOS LIMITED.
+// Copyright 2021-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp_s16.h b/lib_xcore_math/api/xmath/bfp/bfp_s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/bfp/bfp_s32.h b/lib_xcore_math/api/xmath/bfp/bfp_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/dct.h b/lib_xcore_math/api/xmath/dct.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/fft.h b/lib_xcore_math/api/xmath/fft.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/filter.h b/lib_xcore_math/api/xmath/filter.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/q_format.h b/lib_xcore_math/api/xmath/q_format.h
@@ -1,4 +1,4 @@
-// Copyright 2022 XMOS LIMITED.
+// Copyright 2022-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 #pragma once
 

diff --git a/lib_xcore_math/api/xmath/scalar/f32.h b/lib_xcore_math/api/xmath/scalar/f32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/float_complex_s16.h b/lib_xcore_math/api/xmath/scalar/float_complex_s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/float_complex_s32.h b/lib_xcore_math/api/xmath/scalar/float_complex_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/float_s32.h b/lib_xcore_math/api/xmath/scalar/float_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/s16.h b/lib_xcore_math/api/xmath/scalar/s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/s32.h b/lib_xcore_math/api/xmath/scalar/s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/scalar.h b/lib_xcore_math/api/xmath/scalar/scalar.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/scalar/scalar_misc.h b/lib_xcore_math/api/xmath/scalar/scalar_misc.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/types.h b/lib_xcore_math/api/xmath/types.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/util.h b/lib_xcore_math/api/xmath/util.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once
@@ -238,12 +238,16 @@ void xs3_memcpy(
 static inline unsigned cls(
     const int32_t a)
 {
-#ifdef __XS3A__
+#if defined(__XS3A__)
 
     unsigned res;
     asm( "cls %0, %1" : "=r"(res) : "r"(a) );
     return res;
+#elif defined(__VX4B__)
 
+    unsigned res;
+    asm( "xm.cls %0, %1" : "=r"(res) : "r"(a) );
+    return res;
 #else
 
     if(a == 0 || a == -1)

diff --git a/lib_xcore_math/api/xmath/vect/chunk_s32.h b/lib_xcore_math/api/xmath/vect/chunk_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect.h b/lib_xcore_math/api/xmath/vect/vect.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_complex_s16.h b/lib_xcore_math/api/xmath/vect/vect_complex_s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_complex_s16_prepare.h b/lib_xcore_math/api/xmath/vect/vect_complex_s16_prepare.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_complex_s32.h b/lib_xcore_math/api/xmath/vect/vect_complex_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_complex_s32_prepare.h b/lib_xcore_math/api/xmath/vect/vect_complex_s32_prepare.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_f32.h b/lib_xcore_math/api/xmath/vect/vect_f32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_mixed.h b/lib_xcore_math/api/xmath/vect/vect_mixed.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_s16.h b/lib_xcore_math/api/xmath/vect/vect_s16.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_s16_prepare.h b/lib_xcore_math/api/xmath/vect/vect_s16_prepare.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_s32.h b/lib_xcore_math/api/xmath/vect/vect_s32.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_s32_prepare.h b/lib_xcore_math/api/xmath/vect/vect_s32_prepare.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2022 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/vect/vect_s8.h b/lib_xcore_math/api/xmath/vect/vect_s8.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2023 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/xmath.h b/lib_xcore_math/api/xmath/xmath.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/xmath_conf.h b/lib_xcore_math/api/xmath/xmath_conf.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once

diff --git a/lib_xcore_math/api/xmath/xs3/vpu_info.h b/lib_xcore_math/api/xmath/xs3/vpu_info.h
@@ -1,4 +1,4 @@
-// Copyright 2020-2024 XMOS LIMITED.
+// Copyright 2020-2026 XMOS LIMITED.
 // This Software is subject to the terms of the XMOS Public Licence: Version 1.
 
 #pragma once
@@ -72,7 +72,11 @@ enum {
  *
  * @ingroup xs3_vpu_info
 */
-#define VPU_INT8_MIN   ( -0x7F )
+#if defined(__VX4B__)
+#define VPU_INT8_MIN  (  INT8_MIN)
+#else
+#define VPU_INT8_MIN  ( -0x7F )
+#endif
 /** The upper saturation bound for 16-bit elements
  *
  * @ingroup xs3_vpu_info
@@ -82,7 +86,11 @@ enum {
  *
  * @ingroup xs3_vpu_info
 */
+#if defined(__VX4B__)
+#define VPU_INT16_MIN  (  INT16_MIN)
+#else
 #define VPU_INT16_MIN  ( -0x7FFF )
+#endif
 /** The upper saturation bound for 32-bit elements and 32-bit accumulators
  *
  * @ingroup xs3_vpu_info
@@ -92,7 +100,11 @@ enum {
  *
  * @ingroup xs3_vpu_info
 */
+#if defined(__VX4B__)
+#define VPU_INT32_MIN  (  INT32_MIN)
+#else
 #define VPU_INT32_MIN  ( -0x7FFFFFFF )
+#endif
 /** The upper saturation bound for 40-bit accumulators
  *
  * @ingroup xs3_vpu_info
@@ -102,7 +114,11 @@ enum {
  *
  * @ingroup xs3_vpu_info
 */
+#if defined(__VX4B__)
+#define VPU_INT40_MIN  ( -0x8000000000LL)
+#else
 #define VPU_INT40_MIN  ( -0x7FFFFFFFFFLL )
+#endif
 
 /**
  * Number of accumulator bits in each operating mode.