accelerators/stratus_hls/common: add utilities

accelerators/stratus_hls/common/hls/project.tcl

@@ -81,9 +81,10 @@ set COMMON_HLS_FLAGS "--prints=$PRINT"
 # Templates for synthesis
 #
 set ESP_HDRS_PATH "$ESP_ROOT/accelerators/stratus_hls/common/inc"
+set ESP_UTILS_PATH "$ESP_ROOT/accelerators/stratus_hls/common/utils"
 
 #
 # Compiling Options
 #
-set INCLUDES "-I$ESP_HDRS_PATH -I../src -I./memlib"
+set INCLUDES "-I$ESP_HDRS_PATH -I$ESP_UTILS_PATH -I../src -I./memlib"
 

accelerators/stratus_hls/common/utils/common.hpp

@@ -0,0 +1,97 @@
+// Copyright (c) 2011-2021 Columbia University, System Level Design Group
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef __COMMON_HPP__
+#define __COMMON_HPP__
+
+/**
+ * ilog2 - log of base 2 of 32-bit or a 64-bit unsigned value
+ * @n - parameter
+ *
+ * constant-capable log of base 2 calculation
+ * - this can be used to initialise global variables from constant data, hence
+ *   the massive ternary operator construction
+ *
+ */
+#define ilog2(n)				\
+    (						\
+	(n) < 2 ? 0 :				\
+	(n) & (1ULL << 63) ? 63 :		\
+	(n) & (1ULL << 62) ? 62 :		\
+	(n) & (1ULL << 61) ? 61 :		\
+	(n) & (1ULL << 60) ? 60 :		\
+	(n) & (1ULL << 59) ? 59 :		\
+	(n) & (1ULL << 58) ? 58 :		\
+	(n) & (1ULL << 57) ? 57 :		\
+	(n) & (1ULL << 56) ? 56 :		\
+	(n) & (1ULL << 55) ? 55 :		\
+	(n) & (1ULL << 54) ? 54 :		\
+	(n) & (1ULL << 53) ? 53 :		\
+	(n) & (1ULL << 52) ? 52 :		\
+	(n) & (1ULL << 51) ? 51 :		\
+	(n) & (1ULL << 50) ? 50 :		\
+	(n) & (1ULL << 49) ? 49 :		\
+	(n) & (1ULL << 48) ? 48 :		\
+	(n) & (1ULL << 47) ? 47 :		\
+	(n) & (1ULL << 46) ? 46 :		\
+	(n) & (1ULL << 45) ? 45 :		\
+	(n) & (1ULL << 44) ? 44 :		\
+	(n) & (1ULL << 43) ? 43 :		\
+	(n) & (1ULL << 42) ? 42 :		\
+	(n) & (1ULL << 41) ? 41 :		\
+	(n) & (1ULL << 40) ? 40 :		\
+	(n) & (1ULL << 39) ? 39 :		\
+	(n) & (1ULL << 38) ? 38 :		\
+	(n) & (1ULL << 37) ? 37 :		\
+	(n) & (1ULL << 36) ? 36 :		\
+	(n) & (1ULL << 35) ? 35 :		\
+	(n) & (1ULL << 34) ? 34 :		\
+	(n) & (1ULL << 33) ? 33 :		\
+	(n) & (1ULL << 32) ? 32 :		\
+	(n) & (1ULL << 31) ? 31 :		\
+	(n) & (1ULL << 30) ? 30 :		\
+	(n) & (1ULL << 29) ? 29 :		\
+	(n) & (1ULL << 28) ? 28 :		\
+	(n) & (1ULL << 27) ? 27 :		\
+	(n) & (1ULL << 26) ? 26 :		\
+	(n) & (1ULL << 25) ? 25 :		\
+	(n) & (1ULL << 24) ? 24 :		\
+	(n) & (1ULL << 23) ? 23 :		\
+	(n) & (1ULL << 22) ? 22 :		\
+	(n) & (1ULL << 21) ? 21 :		\
+	(n) & (1ULL << 20) ? 20 :		\
+	(n) & (1ULL << 19) ? 19 :		\
+	(n) & (1ULL << 18) ? 18 :		\
+	(n) & (1ULL << 17) ? 17 :		\
+	(n) & (1ULL << 16) ? 16 :		\
+	(n) & (1ULL << 15) ? 15 :		\
+	(n) & (1ULL << 14) ? 14 :		\
+	(n) & (1ULL << 13) ? 13 :		\
+	(n) & (1ULL << 12) ? 12 :		\
+	(n) & (1ULL << 11) ? 11 :		\
+	(n) & (1ULL << 10) ? 10 :		\
+	(n) & (1ULL <<  9) ?  9 :		\
+	(n) & (1ULL <<  8) ?  8 :		\
+	(n) & (1ULL <<  7) ?  7 :		\
+	(n) & (1ULL <<  6) ?  6 :		\
+	(n) & (1ULL <<  5) ?  5 :		\
+	(n) & (1ULL <<  4) ?  4 :		\
+	(n) & (1ULL <<  3) ?  3 :		\
+	(n) & (1ULL <<  2) ?  2 :		\
+	1 )
+
+inline int min(int a, int b){
+    if (a < b)
+	return a;
+    else
+	return b;
+}
+
+inline int max(int a, int b){
+    if (a > b)
+	return a;
+    else
+	return b;
+}
+
+#endif /* __COMMON_HPP__ */