V2.2

Release Notes – Codebase Refactor & Modularization
* Major project restructuring
    * Reorganized libraries and source files into a clearer, more modular directory structure.
    * Moved, renamed, or removed numerous files to reduce duplication and improve maintainability.
* Legacy code cleanup
    * Removed deprecated and unused code from lib-lightset, lib-network, lib-properties, and older display components.
    * Eliminated redundant parameter and platform-specific files no longer in use.
* Centralized common functionality
    * Migrated shared network, properties, and parameter code into a unified common directory.
    * Added new utility headers and source files for reusable functionality.
* JSON-based configuration support
    * Added new JSON configuration and parameter files.
    * Introduced JSON helper utilities and parameter classes to standardize configuration handling and prepare for future extensibility.
* DMX, RDM, and pixel refactor
    * Refactored DMX, RDM device handling, and pixel-related libraries for clearer structure and better separation of responsibilities.
    * Unified RDM device information handling.
* Build system updates
    * Updated Makefiles, build scripts, and compile_commands.json to reflect the new project structure.
    * Improved GD32 platform support and hardware abstraction organization.
* Network stack reorganization
    * Flattened lib-network source layout by moving files from subdirectories into a simpler structure.
    * Improved clarity of EMAC and Linux network interface implementations (no functional changes).
* Debug macro consistency
    * Replaced DEBUG_ENTRY / DEBUG_EXIT macros with function-style DEBUG_ENTRY() / DEBUG_EXIT() across the codebase for consistency and readability.
* Overall impact
    * Significantly improved modularity, readability, and long-term maintainability.
    * Laid groundwork for future feature expansion and more robust JSON-based configuration across modules.

Author: vanvught

.clang-format

@@ -0,0 +1,29 @@
+BasedOnStyle: Google
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+ColumnLimit: 240
+
+PointerAlignment: Left
+ReferenceAlignment: Left
+
+AlignConsecutiveAssignments: false
+AlignConsecutiveDeclarations: false
+
+AllowShortFunctionsOnASingleLine: Inline
+AllowShortIfStatementsOnASingleLine: true
+AllowShortLoopsOnASingleLine: true
+
+BreakBeforeBraces: Allman
+
+DerivePointerAlignment: false
+
+SpacesBeforeTrailingComments: 1
+
+SortIncludes: false
+IncludeBlocks: Preserve
+
+Cpp11BracedListStyle: true
+
+AlwaysBreakAfterReturnType: None
+AlwaysBreakTemplateDeclarations: MultiLine

.clang-tidy

@@ -0,0 +1,82 @@
+Checks: >
+  google-*,
+  readability-identifier-naming,
+  modernize-redundant-void-arg,
+  modernize-concat-nested-namespaces,
+  modernize-use-nullptr,
+  modernize-use-default-member-init,
+  modernize-use-override,
+  -google-runtime-references,
+  -clang-analyzer-*,
+  -misc-unused-include
+
+CheckOptions:
+  - key: readability-identifier-naming.ClassCase
+    value: CamelCase
+
+  - key: readability-identifier-naming.StructCase
+    value: CamelCase
+
+  - key: readability-identifier-naming.FunctionCase
+    value: CamelCase
+
+  - key: readability-identifier-naming.IgnoreMainLikeFunctions
+    value: 'true'
+
+  - key: readability-identifier-naming.IgnoreOverrideFunctions
+    value: 'true'
+
+  - key: readability-identifier-naming.FunctionIgnoredRegexp
+    value: '^([A-Za-z0-9_]+_(IRQHandler|Handler))$'
+
+  - key: readability-identifier-naming.VariableCase
+    value: lower_case
+
+  - key: readability-identifier-naming.ParameterCase
+    value: lower_case
+
+  - key: readability-identifier-naming.PrivateMemberCase
+    value: lower_case
+  - key: readability-identifier-naming.PrivateMemberSuffix
+    value: _
+
+  - key: readability-identifier-naming.PublicMemberCase
+    value: lower_case
+
+  - key: readability-identifier-naming.ConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.ConstantPrefix
+    value: k
+
+  - key: readability-identifier-naming.GlobalConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.GlobalConstantPrefix
+    value: k
+
+  - key: readability-identifier-naming.LocalConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.LocalConstantPrefix
+    value: k
+
+  - key: readability-identifier-naming.EnumCase
+    value: CamelCase
+
+  - key: readability-identifier-naming.EnumConstantCase
+    value: CamelCase
+  - key: readability-identifier-naming.EnumConstantPrefix
+    value: k
+
+  - key: readability-identifier-naming.EnumConstantMemberCase
+    value: CamelCase
+  - key: readability-identifier-naming.EnumConstantMemberPrefix
+    value: k
+
+  - key: readability-identifier-naming.MacroDefinitionCase
+    value: UPPER_CASE
+
+  - key: readability-identifier-naming.TreatAsConstant
+    value: 'constexpr'
+
+WarningsAsErrors: ''
+HeaderFilterRegex: '.*'
+FormatStyle: none

.clangd

@@ -0,0 +1,7 @@
+CompileFlags:
+  CompilationDatabase: .
+
+Diagnostics:
+  ClangTidy:
+    Add: []
+

.gitignore

@@ -77,3 +77,6 @@ Artnet*.*
 do-tftp.sh
 udp_send
 
+*._h
+/.cache
+compile_commands.json

common/.cproject

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-	<name>lib-network</name>
+	<name>common</name>
 	<comment></comment>
 	<projects>
 	</projects>

lib-network/.project common/.projectlib-network/.project renamed to common/.project

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<project>
+	<configuration id="ilg.gnuarmeclipse.managedbuild.cross.toolchain.base.306944287" name="Default">
+		<extension point="org.eclipse.cdt.core.LanguageSettingsProvider">
+			<provider copy-of="extension" id="org.eclipse.cdt.ui.UserLanguageSettingsProvider"/>
+			<provider-reference id="org.eclipse.cdt.core.ReferencedProjectsLanguageSettingsProvider" ref="shared-provider"/>
+			<provider copy-of="extension" id="org.eclipse.cdt.managedbuilder.core.GCCBuildCommandParser"/>
+			<provider class="org.eclipse.cdt.managedbuilder.language.settings.providers.GCCBuiltinSpecsDetector" console="false" env-hash="234589836992184224" id="org.eclipse.embedcdt.managedbuild.cross.arm.core.GCCBuiltinSpecsDetector" keep-relative-paths="false" name="CDT Arm Cross GCC Built-in Compiler Settings" parameter="${COMMAND} ${FLAGS} ${cross_toolchain_flags} -E -P -v -dD &quot;${INPUTS}&quot;" prefer-non-shared="true">
+				<language-scope id="org.eclipse.cdt.core.gcc"/>
+				<language-scope id="org.eclipse.cdt.core.g++"/>
+			</provider>
+			<provider-reference id="org.eclipse.cdt.managedbuilder.core.MBSLanguageSettingsProvider" ref="shared-provider"/>
+		</extension>
+	</configuration>
+</project>

common/.settings/language.settings.xml

@@ -1,8 +1,8 @@
 /**
- * @file putchar.c
+ * @file utils_array.h
  *
  */
-/* Copyright (C) 2020-2021 by Arjan van Vught mailto:info@orangepi-dmx.nl
+/* Copyright (C) 2025 by Arjan van Vught mailto:info@gd32-dmx.org
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -23,9 +23,17 @@
  * THE SOFTWARE.
  */
 
-extern int console_putc(int);
+#ifndef COMMON_UTILS_UTILS_ARRAY_H_
+#define COMMON_UTILS_UTILS_ARRAY_H_
 
-int putchar(int c) {
-	console_putc(c);
-	return 1;
+#include <cstddef>
+
+namespace common
+{
+template <typename T, size_t N> constexpr size_t ArraySize(const T (&)[N]) noexcept
+{
+    return N;
 }
+} // namespace common
+
+#endif  // COMMON_UTILS_UTILS_ARRAY_H_

…ettings/org.eclipse.core.resources.prefs …ettings/org.eclipse.core.resources.prefslib-lightset/.settings/org.eclipse.core.resources.prefs renamed to common/.settings/org.eclipse.core.resources.prefs lib-lightset/.settings/org.eclipse.core.resources.prefs renamed to common/.settings/org.eclipse.core.resources.prefs

@@ -1,8 +1,8 @@
 /**
- * @file uart0.cpp
+ * @file utils_enum.h
  *
  */
-/* Copyright (C) 2023-2024 by Arjan van Vught mailto:info@gd32-dmx.org
+/* Copyright (C) 2025 by Arjan van Vught mailto:info@gd32-dmx.org
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -23,32 +23,26 @@
  * THE SOFTWARE.
  */
 
-#include <cstdarg>
-#include <cstdio>
+#ifndef COMMON_UTILS_UTILS_ENUM_H_
+#define COMMON_UTILS_UTILS_ENUM_H_
 
-static char s_buffer[128];
+#include <type_traits>
 
-extern "C" {
-void uart0_putc(int);
+namespace common
+{
 
-int uart0_printf(const char *fmt, ...) {
-	va_list arp;
-
-	va_start(arp, fmt);
-
-	int i = vsnprintf(s_buffer, sizeof(s_buffer) - 1, fmt, arp);
-
-	va_end(arp);
+/// Converts an enum class value to its underlying integer type.
+template <typename Enum>
+inline auto ToValue(Enum e) noexcept {
+    return static_cast<std::underlying_type_t<Enum>>(e);
+}
 
-	char *s = s_buffer;
+/// Converts an integer value to the corresponding enum class value.
+template <typename Enum>
+inline Enum FromValue(std::underlying_type_t<Enum> value) noexcept {
+    return static_cast<Enum>(value);
+}
 
-	while (*s != '\0') {
-		if (*s == '\n') {
-			uart0_putc('\r');
-		}
-		uart0_putc(*s++);
-	}
+} // namespace common
 
-	return i;
-}
-}
+#endif  // COMMON_UTILS_UTILS_ENUM_H_