Add microtimer package and consumer support

Author: Vanderhell

CMakeLists.txt

@@ -0,0 +1,65 @@
+cmake_minimum_required(VERSION 3.21)
+
+project(microtimer VERSION 1.0.0 LANGUAGES C)
+
+include(CMakePackageConfigHelpers)
+include(GNUInstallDirs)
+
+set(MICROTIMER_MAX_TIMERS "8" CACHE STRING "Resolved timer capacity for this build")
+option(MICROTIMER_BUILD_TESTS "Build microtimer tests" ${PROJECT_IS_TOP_LEVEL})
+
+configure_file(
+    "${CMAKE_CURRENT_SOURCE_DIR}/include/mtimer_config.h.in"
+    "${CMAKE_CURRENT_BINARY_DIR}/include/mtimer_config.h"
+    @ONLY)
+
+add_library(microtimer src/mtimer.c)
+add_library(microtimer::microtimer ALIAS microtimer)
+
+target_compile_features(microtimer PUBLIC c_std_99)
+target_include_directories(microtimer
+    PUBLIC
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
+        $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+        $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>)
+
+set_target_properties(microtimer PROPERTIES
+    EXPORT_NAME microtimer
+    VERSION ${PROJECT_VERSION}
+    SOVERSION ${PROJECT_VERSION_MAJOR})
+
+install(TARGETS microtimer
+    EXPORT microtimerTargets
+    ARCHIVE DESTINATION "${CMAKE_INSTALL_LIBDIR}"
+    LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}"
+    RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}")
+
+install(FILES
+    "${CMAKE_CURRENT_SOURCE_DIR}/include/mtimer.h"
+    "${CMAKE_CURRENT_BINARY_DIR}/include/mtimer_config.h"
+    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}")
+
+install(EXPORT microtimerTargets
+    FILE microtimerTargets.cmake
+    NAMESPACE microtimer::
+    DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/microtimer")
+
+write_basic_package_version_file(
+    "${CMAKE_CURRENT_BINARY_DIR}/microtimerConfigVersion.cmake"
+    VERSION ${PROJECT_VERSION}
+    COMPATIBILITY SameMajorVersion)
+
+configure_package_config_file(
+    "${CMAKE_CURRENT_SOURCE_DIR}/cmake/microtimerConfig.cmake.in"
+    "${CMAKE_CURRENT_BINARY_DIR}/microtimerConfig.cmake"
+    INSTALL_DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/microtimer")
+
+install(FILES
+    "${CMAKE_CURRENT_BINARY_DIR}/microtimerConfig.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/microtimerConfigVersion.cmake"
+    DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/microtimer")
+
+if(MICROTIMER_BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+endif()

Makefile

@@ -0,0 +1,9 @@
+.PHONY: all test clean
+
+all: test
+
+test:
+	$(MAKE) -C tests CC="$(CC)" CPPFLAGS="$(CPPFLAGS)" CFLAGS="$(CFLAGS)" LDFLAGS="$(LDFLAGS)"
+
+clean:
+	$(MAKE) -C tests clean

cmake/microtimerConfig.cmake.in

@@ -0,0 +1,5 @@
+@PACKAGE_INIT@
+
+include("${CMAKE_CURRENT_LIST_DIR}/microtimerTargets.cmake")
+
+check_required_components(microtimer)

include/mtimer_config.h.in

@@ -0,0 +1,24 @@
+#ifndef MTIMER_CONFIG_H
+#define MTIMER_CONFIG_H
+
+#define MTIMER_CONFIG_RESOLVED_MAX_TIMERS @MICROTIMER_MAX_TIMERS@
+
+#if defined(MTIMER_MAX_TIMERS) && (MTIMER_MAX_TIMERS != MTIMER_CONFIG_RESOLVED_MAX_TIMERS)
+#error "microtimer: MTIMER_MAX_TIMERS conflicts with resolved mtimer_config.h"
+#endif
+
+#undef MTIMER_MAX_TIMERS
+#define MTIMER_MAX_TIMERS MTIMER_CONFIG_RESOLVED_MAX_TIMERS
+
+#if (MTIMER_MAX_TIMERS < 1)
+#error "microtimer: MTIMER_MAX_TIMERS must be >= 1"
+#endif
+
+#if (MTIMER_MAX_TIMERS > 255)
+#error "microtimer: MTIMER_MAX_TIMERS must be <= 255 with uint8_t ids"
+#endif
+
+typedef char mtimer_config_assert_max_timers_range[
+    (MTIMER_MAX_TIMERS >= 1 && MTIMER_MAX_TIMERS <= 255) ? 1 : -1];
+
+#endif /* MTIMER_CONFIG_H */

tests/Makefile

@@ -1,14 +1,19 @@
-CC      ?= gcc
-CFLAGS  := -std=c99 -Wall -Wextra -Wpedantic -Werror -I../include -I../../microtest/include
-SRC     := ../src/mtimer.c
+CC ?= cc
+CSTD ?= -std=c99
+WARN_CFLAGS ?= -Wall -Wextra -Wpedantic -Werror
+CPPFLAGS ?=
+CFLAGS ?=
+LDFLAGS ?=
+LDLIBS ?=
+SRC := ../src/mtimer.c
 
 .PHONY: all clean
 
 all: test_all
-	@./test_all
+	./test_all
 
-test_all: test_all.c $(SRC) ../include/mtimer.h
-	$(CC) $(CFLAGS) $(SRC) test_all.c -lm -o $@
+test_all: test_all.c test_harness.h $(SRC) ../include/mtimer.h ../include/mtimer_config.h
+	$(CC) $(CPPFLAGS) -I../include $(CSTD) $(WARN_CFLAGS) $(CFLAGS) $(SRC) test_all.c $(LDFLAGS) $(LDLIBS) -o $@
 
 clean:
-	rm -f test_all
+	$(RM) test_all test_all.exe