From 10cc814dc9580b75cbfd0622e632a389a8295338 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Tue, 27 Jun 2023 17:54:31 +0100 Subject: [PATCH 01/54] Added Why does HarmonyLink require an external program in addition to a game engine plugin? to the readme --- README.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f54a328..4e44de4 100644 --- a/README.md +++ b/README.md @@ -85,23 +85,27 @@ We appreciate your interest in improving HarmonyLinkServer and look forward to y ## Frequently Asked Questions (FAQ) -### Q1: What platforms are supported by HarmonyLink? +### What platforms are supported by HarmonyLink? A: HarmonyLink supports both native Linux and Windows platforms, and extends its functionality to Windows games running on Proton/Wine. -### Q2: How can I get started with HarmonyLink? +### Why does HarmonyLink require an external program in addition to a game engine plugin? + +A: HarmonyLink utilizes an external program alongside the game engine plugin to ensure accurate data is passed to the game and to probe low-level hardware for more precise dock information. By having a separate server-side application, HarmonyLink can establish a standardized API that allows games to access real-time metrics and adapt their settings accordingly. Additionally, the use of an external program helps address potential compatibility issues with Proton/Wine layers and ensures seamless integration with different game engines. + +### How can I get started with HarmonyLink? A: You can start by cloning the HarmonyLinkServer repository. Detailed instructions are provided on the [Getting Started](https://github.com/Jordonbc/HarmonyLinkServer/wiki/Getting-Started) wiki page. -### Q3: Can HarmonyLink be used with games developed in different game engines? +### Can HarmonyLink be used with games developed in different game engines? A: Yes, HarmonyLink is designed to be engine-agnostic and can be used with games developed in different engines. For Unreal Engine, there is a specific [Unreal Engine Plugin](https://github.com/Jordonbc/HarmonyLinkUE) available. -### Q4: Is HarmonyLink only for game developers, or can players also use it? +### Is HarmonyLink only for game developers, or can players also use it? A: While game developers will find HarmonyLink particularly useful for optimizing their games for handheld devices, players can also benefit from the enhanced gaming experience that HarmonyLink provides. -### Q5: Does HarmonyLink have any impact on the performance of the games? +### Does HarmonyLink have any impact on the performance of the games? A: HarmonyLink is designed to be lightweight and efficient, with minimal impact on game performance. The primary purpose of HarmonyLink is to enhance game performance by allowing games to adapt their settings based on real-time device metrics. From 2040878fcf562601eec2fc0bacdfa7a70c0dfebf Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 29 Jun 2023 12:14:29 +0100 Subject: [PATCH 02/54] Added whitelist for Images folder --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 60a465f..34d1b2e 100644 --- a/.gitignore +++ b/.gitignore @@ -5,6 +5,7 @@ !src/** !res/HarmonyLinkLogo.ico !Resources/** +!Images/** !.github/** !Build.rs !Cargo.toml From 1ae88da08b0e916c85d67a5647e79dd3932709b3 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 29 Jun 2023 12:14:44 +0100 Subject: [PATCH 03/54] Added Download Button --- Images/Download Button.png | Bin 0 -> 50788 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 Images/Download Button.png diff --git a/Images/Download Button.png b/Images/Download Button.png new file mode 100644 index 0000000000000000000000000000000000000000..bd944a7bdcd621d9fc2f6929ac3f240976bf4574 GIT binary patch literal 50788 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�#*MM}u7EoLRAy4XR6nfKFxG1Y>>8LXWQO;LPg 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 literal 0 HcmV?d00001 From a7e9336039fd923864868d6c548f4882681db999 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 29 Jun 2023 12:15:26 +0100 Subject: [PATCH 04/54] Added download button image to readme --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 4e44de4..e2e66a0 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,12 @@ HarmonyLinkLogo

+

+ + Download HarmonyLink + +

+ Welcome to the server-side application for the HarmonyLink project. This innovative software is developed with the Rust programming language and is aimed at enhancing the handheld gaming experience. ## Table of Contents From 6bf68eb29820deb045040a80a337b2d1133c16ea Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Jan 2024 20:29:47 +0000 Subject: [PATCH 05/54] Revamp: Transition HarmonyLink to C++ with DLL support This transformative commit marks the evolution of HarmonyLink from a Rust-based server-side application to a C++ implemented, C-compatible dynamic link library (DLL). We've restructured the codebase to streamline integration into games, eliminating the need for a server setup by end-users. Key Changes: - Introduced .gitattributes and .gitmodules to manage new dependencies and collaborations. - Replaced the GitHub workflow files with CMake configurations to support the new C++ build system. - Introduced a comprehensive set of header and implementation files defining the core functionality, platform-specific utilities, and cross-platform compatibility layers. - Removed all Rust-specific files (Cargo.toml, Cargo.lock, etc.) and references to ensure a clean transition to the C++ environment. - Implemented new testing mechanisms within HarmonyLinkTest to ensure robustness and reliability of the DLL. - Excised previous server-side components and models to focus on the DLL's direct integration into consumer applications. This update is a direct response to community feedback, showcasing our commitment to adaptability and innovation. HarmonyLink 2.0 is now more accessible, efficient, and tailored for diverse gaming environments, providing developers with an unparalleled level of hardware-software harmony. Please refer to the updated README for more details on the new structure and how to integrate HarmonyLink 2.0 into your projects. --- .gitattributes | 39 + .github/workflows/release.yml | 59 - .github/workflows/rust-build.yml | 51 - .gitignore | 24 +- .gitmodules | 0 CMakeLists.txt | 70 + Cargo.lock | 1589 ----------------- Cargo.toml | 42 - HarmonyLinkLib/CMakeLists.txt | 129 ++ HarmonyLinkLib/include/Core.h | 14 + HarmonyLinkLib/include/Enums/EDevice.h | 19 + HarmonyLinkLib/include/Enums/EPlatform.h | 15 + HarmonyLinkLib/include/FString.h | 165 ++ HarmonyLinkLib/include/HarmonyLinkLib.h | 44 + HarmonyLinkLib/include/HarmonyLinkStruct.h | 13 + HarmonyLinkLib/include/Structs/FBattery.h | 22 + HarmonyLinkLib/include/Structs/FCPUInfo.h | 40 + HarmonyLinkLib/include/Structs/FDevice.h | 16 + HarmonyLinkLib/include/Structs/FOSVerInfo.h | 50 + HarmonyLinkLib/include/Version.h | 45 + HarmonyLinkLib/include/Version.h.in | 11 + HarmonyLinkLib/src/HarmonyLinkLib.cpp | 94 + .../src/Platform/IPlatformUtilities.cpp | 122 ++ .../src/Platform/IPlatformUtilities.h | 34 + .../Platform/Unix/Linux/LinuxUtilities.cpp | 24 + .../src/Platform/Unix/Linux/LinuxUtilities.h | 23 + .../src/Platform/Unix/Mac/MacUtilities.cpp | 6 + .../src/Platform/Unix/Mac/MacUtilities.h | 11 + .../src/Platform/Unix/UnixUtilities.cpp | 24 + .../src/Platform/Unix/UnixUtilities.h | 16 + .../src/Platform/Windows/WindowsUtilities.cpp | 81 + .../src/Platform/Windows/WindowsUtilities.h | 16 + HarmonyLinkLib/src/Platform/WineUtilities.cpp | 202 +++ HarmonyLinkLib/src/Platform/WineUtilities.h | 46 + HarmonyLinkLib/src/Version.cpp | 1 + HarmonyLinkLib/src/dllmain.cpp | 49 + HarmonyLinkTest/CMakeLists.txt | 31 + HarmonyLinkTest/src/main.cpp | 143 ++ Resources/dock_models.json | 11 - build.rs | 72 - src/api/api.rs | 14 - src/api/endpoints_v1.rs | 99 - src/api/mod.rs | 3 - src/api/server.rs | 28 - src/main.rs | 37 - src/v1/all_info/mod.rs | 2 - src/v1/all_info/stats.rs | 18 - src/v1/all_info/structs.rs | 24 - src/v1/battery/mod.rs | 2 - src/v1/battery/stats.rs | 38 - src/v1/battery/structs.rs | 28 - src/v1/docking/mod.rs | 2 - src/v1/docking/stats.rs | 90 - src/v1/docking/structs.rs | 39 - src/v1/mod.rs | 4 - src/v1/os/mod.rs | 2 - src/v1/os/stats.rs | 45 - src/v1/os/structs.rs | 38 - src/version/info.rs | 41 - src/version/mod.rs | 1 - 60 files changed, 1629 insertions(+), 2389 deletions(-) create mode 100644 .gitattributes delete mode 100644 .github/workflows/release.yml delete mode 100644 .github/workflows/rust-build.yml create mode 100644 .gitmodules create mode 100644 CMakeLists.txt delete mode 100644 Cargo.lock delete mode 100644 Cargo.toml create mode 100644 HarmonyLinkLib/CMakeLists.txt create mode 100644 HarmonyLinkLib/include/Core.h create mode 100644 HarmonyLinkLib/include/Enums/EDevice.h create mode 100644 HarmonyLinkLib/include/Enums/EPlatform.h create mode 100644 HarmonyLinkLib/include/FString.h create mode 100644 HarmonyLinkLib/include/HarmonyLinkLib.h create mode 100644 HarmonyLinkLib/include/HarmonyLinkStruct.h create mode 100644 HarmonyLinkLib/include/Structs/FBattery.h create mode 100644 HarmonyLinkLib/include/Structs/FCPUInfo.h create mode 100644 HarmonyLinkLib/include/Structs/FDevice.h create mode 100644 HarmonyLinkLib/include/Structs/FOSVerInfo.h create mode 100644 HarmonyLinkLib/include/Version.h create mode 100644 HarmonyLinkLib/include/Version.h.in create mode 100644 HarmonyLinkLib/src/HarmonyLinkLib.cpp create mode 100644 HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/IPlatformUtilities.h create mode 100644 HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h create mode 100644 HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h create mode 100644 HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h create mode 100644 HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h create mode 100644 HarmonyLinkLib/src/Platform/WineUtilities.cpp create mode 100644 HarmonyLinkLib/src/Platform/WineUtilities.h create mode 100644 HarmonyLinkLib/src/Version.cpp create mode 100644 HarmonyLinkLib/src/dllmain.cpp create mode 100644 HarmonyLinkTest/CMakeLists.txt create mode 100644 HarmonyLinkTest/src/main.cpp delete mode 100644 Resources/dock_models.json delete mode 100644 build.rs delete mode 100644 src/api/api.rs delete mode 100644 src/api/endpoints_v1.rs delete mode 100644 src/api/mod.rs delete mode 100644 src/api/server.rs delete mode 100644 src/main.rs delete mode 100644 src/v1/all_info/mod.rs delete mode 100644 src/v1/all_info/stats.rs delete mode 100644 src/v1/all_info/structs.rs delete mode 100644 src/v1/battery/mod.rs delete mode 100644 src/v1/battery/stats.rs delete mode 100644 src/v1/battery/structs.rs delete mode 100644 src/v1/docking/mod.rs delete mode 100644 src/v1/docking/stats.rs delete mode 100644 src/v1/docking/structs.rs delete mode 100644 src/v1/mod.rs delete mode 100644 src/v1/os/mod.rs delete mode 100644 src/v1/os/stats.rs delete mode 100644 src/v1/os/structs.rs delete mode 100644 src/version/info.rs delete mode 100644 src/version/mod.rs diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..970e13f --- /dev/null +++ b/.gitattributes @@ -0,0 +1,39 @@ +* text=auto + +# Sources +*.c text diff=cpp +*.cc text diff=cpp +*.cxx text diff=cpp +*.cpp text diff=cpp +*.cpi text diff=cpp +*.c++ text diff=cpp +*.hpp text diff=cpp +*.h text diff=cpp +*.h++ text diff=cpp +*.hh text diff=cpp + +# Compiled Object files +*.slo binary +*.lo binary +*.o binary +*.obj binary + +# Precompiled Headers +*.gch binary +*.pch binary + +# Compiled Dynamic libraries +*.so binary +*.dylib binary +*.dll binary + +# Compiled Static libraries +*.lai binary +*.la binary +*.a binary +*.lib binary + +# Executables +*.exe binary +*.out binary +*.app binary \ No newline at end of file diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml deleted file mode 100644 index 78fd72e..0000000 --- a/.github/workflows/release.yml +++ /dev/null @@ -1,59 +0,0 @@ -# .github/workflows/release.yml - -on: - push: - tags: - - 'release*' - -jobs: - release: - name: release ${{ matrix.target }} - runs-on: ubuntu-latest - strategy: - fail-fast: false - matrix: - include: - - target: x86_64-pc-windows-gnu - archive: zip - - target: x86_64-unknown-linux-musl - archive: tar.gz - steps: - - uses: actions/checkout@master - with: - ssh-key: "${{secrets.RELEASE_KEY}}" - - uses: Swatinem/rust-cache@v2 - with: - # The prefix cache key, this can be changed to start a new cache manually. - # default: "v0-rust" - prefix-key: "" - - # A cache key that is used instead of the automatic `job`-based key, - # and is stable over multiple jobs. - # default: empty - shared-key: "" - - # An additional cache key that is added alongside the automatic `job`-based - # cache key and can be used to further differentiate jobs. - # default: empty - key: "" - - # A whitespace separated list of env-var *prefixes* who's value contributes - # to the environment cache key. - # The env-vars are matched by *prefix*, so the default `RUST` var will - # match all of `RUSTC`, `RUSTUP_*`, `RUSTFLAGS`, `RUSTDOC_*`, etc. - # default: "CARGO CC CFLAGS CXX CMAKE RUST" - env-vars: "" - - # The cargo workspaces and target directory configuration. - # These entries are separated by newlines and have the form - # `$workspace -> $target`. The `$target` part is treated as a directory - # relative to the `$workspace` and defaults to "target" if not explicitly given. - # default: ". -> target" - workspaces: ". -> target" - - name: Compile and release - uses: rust-build/rust-build.action@v1.4.3 - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - with: - RUSTTARGET: ${{ matrix.target }} - ARCHIVE_TYPES: ${{ matrix.archive }} \ No newline at end of file diff --git a/.github/workflows/rust-build.yml b/.github/workflows/rust-build.yml deleted file mode 100644 index 6cd0a6a..0000000 --- a/.github/workflows/rust-build.yml +++ /dev/null @@ -1,51 +0,0 @@ -name: Rust - -on: - push: - branches: [ "stable" ] - pull_request: - branches: [ "stable" ] - -env: - CARGO_TERM_COLOR: always - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v3 - - uses: Swatinem/rust-cache@v2 - with: - # The prefix cache key, this can be changed to start a new cache manually. - # default: "v0-rust" - prefix-key: "" - - # A cache key that is used instead of the automatic `job`-based key, - # and is stable over multiple jobs. - # default: empty - shared-key: "" - - # An additional cache key that is added alongside the automatic `job`-based - # cache key and can be used to further differentiate jobs. - # default: empty - key: "" - - # A whitespace separated list of env-var *prefixes* who's value contributes - # to the environment cache key. - # The env-vars are matched by *prefix*, so the default `RUST` var will - # match all of `RUSTC`, `RUSTUP_*`, `RUSTFLAGS`, `RUSTDOC_*`, etc. - # default: "CARGO CC CFLAGS CXX CMAKE RUST" - env-vars: "" - - # The cargo workspaces and target directory configuration. - # These entries are separated by newlines and have the form - # `$workspace -> $target`. The `$target` part is treated as a directory - # relative to the `$workspace` and defaults to "target" if not explicitly given. - # default: ". -> target" - workspaces: ". -> target" - - name: Build - run: cargo build --verbose - - name: Run tests - run: cargo test --verbose diff --git a/.gitignore b/.gitignore index 34d1b2e..d567bc0 100644 --- a/.gitignore +++ b/.gitignore @@ -1,14 +1,18 @@ +# Setup .gitignore as a whitelist * !*/ +build/** + +# track this file !.gitignore -!src/** -!res/HarmonyLinkLogo.ico -!Resources/** -!Images/** -!.github/** -!Build.rs -!Cargo.toml -!Cargo.lock -!LICENSE -!README.md \ No newline at end of file +!.gitattributes +!.gitmodules + +!CMakeLists.txt +!license +!readme.md + +!HarmonyLinkLib/** +!HarmonyLinkTest/** +!tests/** \ No newline at end of file diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..e69de29 diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 0000000..2bf0723 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,70 @@ +cmake_minimum_required(VERSION 3.10) +project(HarmonyLinkProject) + +# Check the build type and display a message accordingly +if(CMAKE_BUILD_TYPE STREQUAL "Debug") + message(STATUS "Building for Debug") +elseif(CMAKE_BUILD_TYPE STREQUAL "Release") + message(STATUS "Building for Release") +elseif(CMAKE_BUILD_TYPE STREQUAL "MinSizeRel") + message(STATUS "Building for MinSizeRel") +elseif(CMAKE_BUILD_TYPE STREQUAL "RelWithDebInfo") + message(STATUS "Building for RelWithDebInfo") +else() + message(STATUS "Building with unspecified build type") +endif() + +#set(gtest_force_shared_crt ON CACHE BOOL "" FORCE) + +# Platform-specific definitions +if(WIN32) + add_definitions(-DBUILD_WINDOWS) +elseif(UNIX) + if(APPLE) + add_definitions(-DBUILD_MACOS) + else() + add_definitions(-DBUILD_LINUX) + endif() + add_definitions(-DBUILD_UNIX) +endif() + +# Set global output directories for all build types +foreach(TYPE IN ITEMS DEBUG RELEASE) + string(TOUPPER ${TYPE} TYPE_UPPER) + set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}") + set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}") + set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}") +endforeach() + +# Add the library and executable directories + +add_subdirectory(HarmonyLinkLib) +add_subdirectory(HarmonyLinkTest) + +# Add Google Test as a subdirectory +#add_subdirectory(ThirdParty/googletest) + +# Enable testing +#enable_testing() + +# Include Google Test's include directory +#include_directories(ThirdParty/googletest/googletest/include) + +# Define your test executable +#file(GLOB_RECURSE TEST_SOURCES "tests/*.cpp") +#add_executable(Testing ${TEST_SOURCES}) + +# Set HarmonyLinkTest as the default startup project +set_property(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} PROPERTY VS_STARTUP_PROJECT HarmonyLinkTest) + +# Link Google Test and HarmonyLink library to the test executable +#target_link_libraries(Testing gtest gtest_main gmock HarmonyLinkLib) + +#add_custom_command(TARGET Testing POST_BUILD +# COMMAND ${CMAKE_COMMAND} -E copy_if_different +# "$" +# "$") + +# Discover tests +#include(GoogleTest) +#gtest_discover_tests(Testing) diff --git a/Cargo.lock b/Cargo.lock deleted file mode 100644 index d46817e..0000000 --- a/Cargo.lock +++ /dev/null @@ -1,1589 +0,0 @@ -# This file is automatically @generated by Cargo. -# It is not intended for manual editing. -version = 3 - -[[package]] -name = "actix-codec" -version = "0.5.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "617a8268e3537fe1d8c9ead925fca49ef6400927ee7bc26750e90ecee14ce4b8" -dependencies = [ - "bitflags", - "bytes", - "futures-core", - "futures-sink", - "memchr", - "pin-project-lite", - "tokio", - "tokio-util", - "tracing", -] - -[[package]] -name = "actix-http" -version = "3.3.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c2079246596c18b4a33e274ae10c0e50613f4d32a4198e09c7b93771013fed74" -dependencies = [ - "actix-codec", - "actix-rt", - "actix-service", - "actix-utils", - "ahash 0.8.3", - "base64", - "bitflags", - "brotli", - "bytes", - "bytestring", - "derive_more", - "encoding_rs", - "flate2", - "futures-core", - "h2", - "http", - "httparse", - "httpdate", - "itoa", - "language-tags", - "local-channel", - "mime", - "percent-encoding", - "pin-project-lite", - "rand", - "sha1", - "smallvec", - "tokio", - "tokio-util", - "tracing", - "zstd", -] - -[[package]] -name = "actix-macros" -version = "0.2.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "465a6172cf69b960917811022d8f29bc0b7fa1398bc4f78b3c466673db1213b6" -dependencies = [ - "quote", - "syn 1.0.109", -] - -[[package]] -name = "actix-router" -version = "0.5.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d66ff4d247d2b160861fa2866457e85706833527840e4133f8f49aa423a38799" -dependencies = [ - "bytestring", - "http", - "regex", - "serde", - "tracing", -] - -[[package]] -name = "actix-rt" -version = "2.8.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "15265b6b8e2347670eb363c47fc8c75208b4a4994b27192f345fcbe707804f3e" -dependencies = [ - "futures-core", - "tokio", -] - -[[package]] -name = "actix-server" -version = "2.2.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3e8613a75dd50cc45f473cee3c34d59ed677c0f7b44480ce3b8247d7dc519327" -dependencies = [ - "actix-rt", - "actix-service", - "actix-utils", - "futures-core", - "futures-util", - "mio", - "num_cpus", - "socket2", - "tokio", - "tracing", -] - -[[package]] -name = "actix-service" -version = "2.0.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3b894941f818cfdc7ccc4b9e60fa7e53b5042a2e8567270f9147d5591893373a" -dependencies = [ - "futures-core", - "paste", - "pin-project-lite", -] - -[[package]] -name = "actix-utils" -version = "3.0.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "88a1dcdff1466e3c2488e1cb5c36a71822750ad43839937f85d2f4d9f8b705d8" -dependencies = [ - "local-waker", - "pin-project-lite", -] - -[[package]] -name = "actix-web" -version = "4.3.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "cd3cb42f9566ab176e1ef0b8b3a896529062b4efc6be0123046095914c4c1c96" -dependencies = [ - "actix-codec", - "actix-http", - "actix-macros", - "actix-router", - "actix-rt", - "actix-server", - "actix-service", - "actix-utils", - "actix-web-codegen", - "ahash 0.7.6", - "bytes", - "bytestring", - "cfg-if", - "cookie", - "derive_more", - "encoding_rs", - "futures-core", - "futures-util", - "http", - "itoa", - "language-tags", - "log", - "mime", - "once_cell", - "pin-project-lite", - "regex", - "serde", - "serde_json", - "serde_urlencoded", - "smallvec", - "socket2", - "time", - "url", -] - -[[package]] -name = "actix-web-codegen" -version = "4.2.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2262160a7ae29e3415554a3f1fc04c764b1540c116aa524683208078b7a75bc9" -dependencies = [ - "actix-router", - "proc-macro2", - "quote", - "syn 1.0.109", -] - -[[package]] -name = "adler" -version = "1.0.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe" - -[[package]] -name = "ahash" -version = "0.7.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fcb51a0695d8f838b1ee009b3fbf66bda078cd64590202a864a8f3e8c4315c47" -dependencies = [ - "getrandom", - "once_cell", - "version_check", -] - -[[package]] -name = "ahash" -version = "0.8.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2c99f64d1e06488f620f932677e24bc6e2897582980441ae90a671415bd7ec2f" -dependencies = [ - "cfg-if", - "getrandom", - "once_cell", - "version_check", -] - -[[package]] -name = "aho-corasick" -version = "1.0.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "43f6cb1bf222025340178f382c426f13757b2960e89779dfcb319c32542a5a41" -dependencies = [ - "memchr", -] - -[[package]] -name = "alloc-no-stdlib" -version = "2.0.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "cc7bb162ec39d46ab1ca8c77bf72e890535becd1751bb45f64c597edb4c8c6b3" - -[[package]] -name = "alloc-stdlib" -version = "0.2.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "94fb8275041c72129eb51b7d0322c29b8387a0386127718b096429201a5d6ece" -dependencies = [ - "alloc-no-stdlib", -] - -[[package]] -name = "anyhow" -version = "1.0.71" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9c7d0618f0e0b7e8ff11427422b64564d5fb0be1940354bfe2e0529b18a9d9b8" - -[[package]] -name = "autocfg" -version = "1.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa" - -[[package]] -name = "base64" -version = "0.21.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "604178f6c5c21f02dc555784810edfb88d34ac2c73b2eae109655649ee73ce3d" - -[[package]] -name = "battery" -version = "0.7.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b4b624268937c0e0a3edb7c27843f9e547c320d730c610d3b8e6e8e95b2026e4" -dependencies = [ - "cfg-if", - "core-foundation", - "lazycell", - "libc", - "mach", - "nix", - "num-traits", - "uom", - "winapi", -] - -[[package]] -name = "bitflags" -version = "1.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a" - -[[package]] -name = "block-buffer" -version = "0.10.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71" -dependencies = [ - "generic-array", -] - -[[package]] -name = "brotli" -version = "3.3.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a1a0b1dbcc8ae29329621f8d4f0d835787c1c38bb1401979b49d13b0b305ff68" -dependencies = [ - "alloc-no-stdlib", - "alloc-stdlib", - "brotli-decompressor", -] - -[[package]] -name = "brotli-decompressor" -version = "2.3.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4b6561fd3f895a11e8f72af2cb7d22e08366bebc2b6b57f7744c4bda27034744" -dependencies = [ - "alloc-no-stdlib", - "alloc-stdlib", -] - -[[package]] -name = "bytes" -version = "1.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "89b2fd2a0dcf38d7971e2194b6b6eebab45ae01067456a7fd93d5547a61b70be" - -[[package]] -name = "bytestring" -version = "1.3.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "238e4886760d98c4f899360c834fa93e62cf7f721ac3c2da375cbdf4b8679aae" -dependencies = [ - "bytes", -] - -[[package]] -name = "cc" -version = "1.0.79" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "50d30906286121d95be3d479533b458f87493b30a4b5f79a607db8f5d11aa91f" -dependencies = [ - "jobserver", -] - -[[package]] -name = "cfg-if" -version = "1.0.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd" - -[[package]] -name = "convert_case" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6245d59a3e82a7fc217c5828a6692dbc6dfb63a0c8c90495621f7b9d79704a0e" - -[[package]] -name = "cookie" -version = "0.16.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e859cd57d0710d9e06c381b550c06e76992472a8c6d527aecd2fc673dcc231fb" -dependencies = [ - "percent-encoding", - "time", - "version_check", -] - -[[package]] -name = "core-foundation" -version = "0.7.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "57d24c7a13c43e870e37c1556b74555437870a04514f7685f5b354e090567171" -dependencies = [ - "core-foundation-sys 0.7.0", - "libc", -] - -[[package]] -name = "core-foundation-sys" -version = "0.7.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b3a71ab494c0b5b860bdc8407ae08978052417070c2ced38573a9157ad75b8ac" - -[[package]] -name = "core-foundation-sys" -version = "0.8.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e496a50fda8aacccc86d7529e2c1e0892dbd0f898a6b5645b5561b89c3210efa" - -[[package]] -name = "cpufeatures" -version = "0.2.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "03e69e28e9f7f77debdedbaafa2866e1de9ba56df55a8bd7cfc724c25a09987c" -dependencies = [ - "libc", -] - -[[package]] -name = "crc32fast" -version = "1.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b540bd8bc810d3885c6ea91e2018302f68baba2129ab3e88f32389ee9370880d" -dependencies = [ - "cfg-if", -] - -[[package]] -name = "crossbeam-channel" -version = "0.5.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a33c2bf77f2df06183c3aa30d1e96c0695a313d4f9c453cc3762a6db39f99200" -dependencies = [ - "cfg-if", - "crossbeam-utils", -] - -[[package]] -name = "crossbeam-deque" -version = "0.8.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ce6fd6f855243022dcecf8702fef0c297d4338e226845fe067f6341ad9fa0cef" -dependencies = [ - "cfg-if", - "crossbeam-epoch", - "crossbeam-utils", -] - -[[package]] -name = "crossbeam-epoch" -version = "0.9.15" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ae211234986c545741a7dc064309f67ee1e5ad243d0e48335adc0484d960bcc7" -dependencies = [ - "autocfg", - "cfg-if", - "crossbeam-utils", - "memoffset", - "scopeguard", -] - -[[package]] -name = "crossbeam-utils" -version = "0.8.16" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5a22b2d63d4d1dc0b7f1b6b2747dd0088008a9be28b6ddf0b1e7d335e3037294" -dependencies = [ - "cfg-if", -] - -[[package]] -name = "crypto-common" -version = "0.1.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3" -dependencies = [ - "generic-array", - "typenum", -] - -[[package]] -name = "derive_more" -version = "0.99.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4fb810d30a7c1953f91334de7244731fc3f3c10d7fe163338a35b9f640960321" -dependencies = [ - "convert_case", - "proc-macro2", - "quote", - "rustc_version", - "syn 1.0.109", -] - -[[package]] -name = "digest" -version = "0.10.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292" -dependencies = [ - "block-buffer", - "crypto-common", -] - -[[package]] -name = "either" -version = "1.8.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7fcaabb2fef8c910e7f4c7ce9f67a1283a1715879a7c230ca9d6d1ae31f16d91" - -[[package]] -name = "encoding_rs" -version = "0.8.32" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "071a31f4ee85403370b58aca746f01041ede6f0da2730960ad001edc2b71b394" -dependencies = [ - "cfg-if", -] - -[[package]] -name = "env_logger" -version = "0.10.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "85cdab6a89accf66733ad5a1693a4dcced6aeff64602b634530dd73c1f3ee9f0" -dependencies = [ - "humantime", - "is-terminal", - "log", - "regex", - "termcolor", -] - -[[package]] -name = "errno" -version = "0.3.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4bcfec3a70f97c962c307b2d2c56e358cf1d00b558d74262b5f929ee8cc7e73a" -dependencies = [ - "errno-dragonfly", - "libc", - "windows-sys", -] - -[[package]] -name = "errno-dragonfly" -version = "0.1.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "aa68f1b12764fab894d2755d2518754e71b4fd80ecfb822714a1206c2aab39bf" -dependencies = [ - "cc", - "libc", -] - -[[package]] -name = "flate2" -version = "1.0.26" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3b9429470923de8e8cbd4d2dc513535400b4b3fef0319fb5c4e1f520a7bef743" -dependencies = [ - "crc32fast", - "miniz_oxide", -] - -[[package]] -name = "fnv" -version = "1.0.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1" - -[[package]] -name = "form_urlencoded" -version = "1.2.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a62bc1cf6f830c2ec14a513a9fb124d0a213a629668a4186f329db21fe045652" -dependencies = [ - "percent-encoding", -] - -[[package]] -name = "futures-core" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4bca583b7e26f571124fe5b7561d49cb2868d79116cfa0eefce955557c6fee8c" - -[[package]] -name = "futures-sink" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f43be4fe21a13b9781a69afa4985b0f6ee0e1afab2c6f454a8cf30e2b2237b6e" - -[[package]] -name = "futures-task" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "76d3d132be6c0e6aa1534069c705a74a5997a356c0dc2f86a47765e5617c5b65" - -[[package]] -name = "futures-util" -version = "0.3.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "26b01e40b772d54cf6c6d721c1d1abd0647a0106a12ecaa1c186273392a69533" -dependencies = [ - "futures-core", - "futures-task", - "pin-project-lite", - "pin-utils", -] - -[[package]] -name = "generic-array" -version = "0.14.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a" -dependencies = [ - "typenum", - "version_check", -] - -[[package]] -name = "getrandom" -version = "0.2.10" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "be4136b2a15dd319360be1c07d9933517ccf0be8f16bf62a3bee4f0d618df427" -dependencies = [ - "cfg-if", - "libc", - "wasi", -] - -[[package]] -name = "h2" -version = "0.3.19" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d357c7ae988e7d2182f7d7871d0b963962420b0678b0997ce7de72001aeab782" -dependencies = [ - "bytes", - "fnv", - "futures-core", - "futures-sink", - "futures-util", - "http", - "indexmap", - "slab", - "tokio", - "tokio-util", - "tracing", -] - -[[package]] -name = "harmony_link_server" -version = "0.2.0" -dependencies = [ - "actix-web", - "battery", - "env_logger", - "lazy_static", - "log", - "os_info", - "rusb", - "serde", - "serde_json", - "sysinfo", - "vergen", - "winres", -] - -[[package]] -name = "hashbrown" -version = "0.12.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888" - -[[package]] -name = "hermit-abi" -version = "0.2.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ee512640fe35acbfb4bb779db6f0d80704c2cacfa2e39b601ef3e3f47d1ae4c7" -dependencies = [ - "libc", -] - -[[package]] -name = "hermit-abi" -version = "0.3.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fed44880c466736ef9a5c5b5facefb5ed0785676d0c02d612db14e54f0d84286" - -[[package]] -name = "http" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bd6effc99afb63425aff9b05836f029929e345a6148a14b7ecd5ab67af944482" -dependencies = [ - "bytes", - "fnv", - "itoa", -] - -[[package]] -name = "httparse" -version = "1.8.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d897f394bad6a705d5f4104762e116a75639e470d80901eed05a860a95cb1904" - -[[package]] -name = "httpdate" -version = "1.0.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c4a1e36c821dbe04574f602848a19f742f4fb3c98d40449f11bcad18d6b17421" - -[[package]] -name = "humantime" -version = "2.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9a3a5bfb195931eeb336b2a7b4d761daec841b97f947d34394601737a7bba5e4" - -[[package]] -name = "idna" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7d20d6b07bfbc108882d88ed8e37d39636dcc260e15e30c45e6ba089610b917c" -dependencies = [ - "unicode-bidi", - "unicode-normalization", -] - -[[package]] -name = "indexmap" -version = "1.9.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bd070e393353796e801d209ad339e89596eb4c8d430d18ede6a1cced8fafbd99" -dependencies = [ - "autocfg", - "hashbrown", -] - -[[package]] -name = "io-lifetimes" -version = "1.0.11" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "eae7b9aee968036d54dce06cebaefd919e4472e753296daccd6d344e3e2df0c2" -dependencies = [ - "hermit-abi 0.3.1", - "libc", - "windows-sys", -] - -[[package]] -name = "is-terminal" -version = "0.4.7" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "adcf93614601c8129ddf72e2d5633df827ba6551541c6d8c59520a371475be1f" -dependencies = [ - "hermit-abi 0.3.1", - "io-lifetimes", - "rustix", - "windows-sys", -] - -[[package]] -name = "itoa" -version = "1.0.6" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "453ad9f582a441959e5f0d088b02ce04cfe8d51a8eaf077f12ac6d3e94164ca6" - -[[package]] -name = "jobserver" -version = "0.1.26" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "936cfd212a0155903bcbc060e316fb6cc7cbf2e1907329391ebadc1fe0ce77c2" -dependencies = [ - "libc", -] - -[[package]] -name = "language-tags" -version = "0.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d4345964bb142484797b161f473a503a434de77149dd8c7427788c6e13379388" - -[[package]] -name = "lazy_static" -version = "1.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646" - -[[package]] -name = "lazycell" -version = "1.3.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "830d08ce1d1d941e6b30645f1a0eb5643013d835ce3779a5fc208261dbe10f55" - -[[package]] -name = "libc" -version = "0.2.146" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f92be4933c13fd498862a9e02a3055f8a8d9c039ce33db97306fd5a6caa7f29b" - -[[package]] -name = "libusb1-sys" -version = "0.6.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f9d0e2afce4245f2c9a418511e5af8718bcaf2fa408aefb259504d1a9cb25f27" -dependencies = [ - "cc", - "libc", - "pkg-config", - "vcpkg", -] - -[[package]] -name = "linux-raw-sys" -version = "0.3.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ef53942eb7bf7ff43a617b3e2c1c4a5ecf5944a7c1bc12d7ee39bbb15e5c1519" - -[[package]] -name = "local-channel" -version = "0.1.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7f303ec0e94c6c54447f84f3b0ef7af769858a9c4ef56ef2a986d3dcd4c3fc9c" -dependencies = [ - "futures-core", - "futures-sink", - "futures-util", - "local-waker", -] - -[[package]] -name = "local-waker" -version = "0.1.3" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e34f76eb3611940e0e7d53a9aaa4e6a3151f69541a282fd0dad5571420c53ff1" - -[[package]] -name = "lock_api" -version = "0.4.10" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c1cc9717a20b1bb222f333e6a92fd32f7d8a18ddc5a3191a11af45dcbf4dcd16" -dependencies = [ - "autocfg", - "scopeguard", -] - -[[package]] -name = "log" -version = "0.4.19" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b06a4cde4c0f271a446782e3eff8de789548ce57dbc8eca9292c27f4a42004b4" - -[[package]] -name = "mach" -version = "0.3.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b823e83b2affd8f40a9ee8c29dbc56404c1e34cd2710921f2801e2cf29527afa" -dependencies = [ - "libc", -] - -[[package]] -name = "memchr" -version = "2.5.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d" - -[[package]] -name = "memoffset" -version = "0.9.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5a634b1c61a95585bd15607c6ab0c4e5b226e695ff2800ba0cdccddf208c406c" -dependencies = [ - "autocfg", -] - -[[package]] -name = "mime" -version = "0.3.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a" - -[[package]] -name = "miniz_oxide" -version = "0.7.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e7810e0be55b428ada41041c41f32c9f1a42817901b4ccf45fa3d4b6561e74c7" -dependencies = [ - "adler", -] - -[[package]] -name = "mio" -version = "0.8.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "927a765cd3fc26206e66b296465fa9d3e5ab003e651c1b3c060e7956d96b19d2" -dependencies = [ - "libc", - "log", - "wasi", - "windows-sys", -] - -[[package]] -name = "nix" -version = "0.19.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b2ccba0cfe4fdf15982d1674c69b1fd80bad427d293849982668dfe454bd61f2" -dependencies = [ - "bitflags", - "cc", - "cfg-if", - "libc", -] - -[[package]] -name = "ntapi" -version = "0.4.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e8a3895c6391c39d7fe7ebc444a87eb2991b2a0bc718fdabd071eec617fc68e4" -dependencies = [ - "winapi", -] - -[[package]] -name = "num-traits" -version = "0.2.15" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "578ede34cf02f8924ab9447f50c28075b4d3e5b269972345e7e0372b38c6cdcd" -dependencies = [ - "autocfg", -] - -[[package]] -name = "num_cpus" -version = "1.15.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0fac9e2da13b5eb447a6ce3d392f23a29d8694bff781bf03a16cd9ac8697593b" -dependencies = [ - "hermit-abi 0.2.6", - "libc", -] - -[[package]] -name = "once_cell" -version = "1.18.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d" - -[[package]] -name = "os_info" -version = "3.7.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "006e42d5b888366f1880eda20371fedde764ed2213dc8496f49622fa0c99cd5e" -dependencies = [ - "log", - "serde", - "winapi", -] - -[[package]] -name = "parking_lot" -version = "0.12.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f" -dependencies = [ - "lock_api", - "parking_lot_core", -] - -[[package]] -name = "parking_lot_core" -version = "0.9.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "93f00c865fe7cabf650081affecd3871070f26767e7b2070a3ffae14c654b447" -dependencies = [ - "cfg-if", - "libc", - "redox_syscall", - "smallvec", - "windows-targets", -] - -[[package]] -name = "paste" -version = "1.0.12" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9f746c4065a8fa3fe23974dd82f15431cc8d40779821001404d10d2e79ca7d79" - -[[package]] -name = "percent-encoding" -version = "2.3.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9b2a4787296e9989611394c33f193f676704af1686e70b8f8033ab5ba9a35a94" - -[[package]] -name = "pin-project-lite" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e0a7ae3ac2f1173085d398531c705756c94a4c56843785df85a60c1a0afac116" - -[[package]] -name = "pin-utils" -version = "0.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184" - -[[package]] -name = "pkg-config" -version = "0.3.27" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "26072860ba924cbfa98ea39c8c19b4dd6a4a25423dbdf219c1eca91aa0cf6964" - -[[package]] -name = "ppv-lite86" -version = "0.2.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de" - -[[package]] -name = "proc-macro2" -version = "1.0.60" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "dec2b086b7a862cf4de201096214fa870344cf922b2b30c167badb3af3195406" -dependencies = [ - "unicode-ident", -] - -[[package]] -name = "quote" -version = "1.0.28" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1b9ab9c7eadfd8df19006f1cf1a4aed13540ed5cbc047010ece5826e10825488" -dependencies = [ - "proc-macro2", -] - -[[package]] -name = "rand" -version = "0.8.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404" -dependencies = [ - "libc", - "rand_chacha", - "rand_core", -] - -[[package]] -name = "rand_chacha" -version = "0.3.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88" -dependencies = [ - "ppv-lite86", - "rand_core", -] - -[[package]] -name = "rand_core" -version = "0.6.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c" -dependencies = [ - "getrandom", -] - -[[package]] -name = "rayon" -version = "1.7.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1d2df5196e37bcc87abebc0053e20787d73847bb33134a69841207dd0a47f03b" -dependencies = [ - "either", - "rayon-core", -] - -[[package]] -name = "rayon-core" -version = "1.11.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4b8f95bd6966f5c87776639160a66bd8ab9895d9d4ab01ddba9fc60661aebe8d" -dependencies = [ - "crossbeam-channel", - "crossbeam-deque", - "crossbeam-utils", - "num_cpus", -] - -[[package]] -name = "redox_syscall" -version = "0.3.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "567664f262709473930a4bf9e51bf2ebf3348f2e748ccc50dea20646858f8f29" -dependencies = [ - "bitflags", -] - -[[package]] -name = "regex" -version = "1.8.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d0ab3ca65655bb1e41f2a8c8cd662eb4fb035e67c3f78da1d61dffe89d07300f" -dependencies = [ - "aho-corasick", - "memchr", - "regex-syntax", -] - -[[package]] -name = "regex-syntax" -version = "0.7.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "436b050e76ed2903236f032a59761c1eb99e1b0aead2c257922771dab1fc8c78" - -[[package]] -name = "rusb" -version = "0.9.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "44a8c36914f9b1a3be712c1dfa48c9b397131f9a75707e570a391735f785c5d1" -dependencies = [ - "libc", - "libusb1-sys", -] - -[[package]] -name = "rustc_version" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bfa0f585226d2e68097d4f95d113b15b83a82e819ab25717ec0590d9584ef366" -dependencies = [ - "semver", -] - -[[package]] -name = "rustix" -version = "0.37.20" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b96e891d04aa506a6d1f318d2771bcb1c7dfda84e126660ace067c9b474bb2c0" -dependencies = [ - "bitflags", - "errno", - "io-lifetimes", - "libc", - "linux-raw-sys", - "windows-sys", -] - -[[package]] -name = "rustversion" -version = "1.0.12" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4f3208ce4d8448b3f3e7d168a73f5e0c43a61e32930de3bceeccedb388b6bf06" - -[[package]] -name = "ryu" -version = "1.0.13" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f91339c0467de62360649f8d3e185ca8de4224ff281f66000de5eb2a77a79041" - -[[package]] -name = "scopeguard" -version = "1.1.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d29ab0c6d3fc0ee92fe66e2d99f700eab17a8d57d1c1d3b748380fb20baa78cd" - -[[package]] -name = "semver" -version = "1.0.17" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bebd363326d05ec3e2f532ab7660680f3b02130d780c299bca73469d521bc0ed" - -[[package]] -name = "serde" -version = "1.0.164" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9e8c8cf938e98f769bc164923b06dce91cea1751522f46f8466461af04c9027d" -dependencies = [ - "serde_derive", -] - -[[package]] -name = "serde_derive" -version = "1.0.164" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d9735b638ccc51c28bf6914d90a2e9725b377144fc612c49a611fddd1b631d68" -dependencies = [ - "proc-macro2", - "quote", - "syn 2.0.18", -] - -[[package]] -name = "serde_json" -version = "1.0.97" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "bdf3bf93142acad5821c99197022e170842cdbc1c30482b98750c688c640842a" -dependencies = [ - "itoa", - "ryu", - "serde", -] - -[[package]] -name = "serde_urlencoded" -version = "0.7.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd" -dependencies = [ - "form_urlencoded", - "itoa", - "ryu", - "serde", -] - -[[package]] -name = "sha1" -version = "0.10.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f04293dc80c3993519f2d7f6f511707ee7094fe0c6d3406feb330cdb3540eba3" -dependencies = [ - "cfg-if", - "cpufeatures", - "digest", -] - -[[package]] -name = "signal-hook-registry" -version = "1.4.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d8229b473baa5980ac72ef434c4415e70c4b5e71b423043adb4ba059f89c99a1" -dependencies = [ - "libc", -] - -[[package]] -name = "slab" -version = "0.4.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6528351c9bc8ab22353f9d776db39a20288e8d6c37ef8cfe3317cf875eecfc2d" -dependencies = [ - "autocfg", -] - -[[package]] -name = "smallvec" -version = "1.10.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a507befe795404456341dfab10cef66ead4c041f62b8b11bbb92bffe5d0953e0" - -[[package]] -name = "socket2" -version = "0.4.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "64a4a911eed85daf18834cfaa86a79b7d266ff93ff5ba14005426219480ed662" -dependencies = [ - "libc", - "winapi", -] - -[[package]] -name = "syn" -version = "1.0.109" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237" -dependencies = [ - "proc-macro2", - "quote", - "unicode-ident", -] - -[[package]] -name = "syn" -version = "2.0.18" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "32d41677bcbe24c20c52e7c70b0d8db04134c5d1066bf98662e2871ad200ea3e" -dependencies = [ - "proc-macro2", - "quote", - "unicode-ident", -] - -[[package]] -name = "sysinfo" -version = "0.29.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9557d0845b86eea8182f7b10dff120214fb6cd9fd937b6f4917714e546a38695" -dependencies = [ - "cfg-if", - "core-foundation-sys 0.8.4", - "libc", - "ntapi", - "once_cell", - "rayon", - "winapi", -] - -[[package]] -name = "termcolor" -version = "1.2.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "be55cf8942feac5c765c2c993422806843c9a9a45d4d5c407ad6dd2ea95eb9b6" -dependencies = [ - "winapi-util", -] - -[[package]] -name = "time" -version = "0.3.22" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ea9e1b3cf1243ae005d9e74085d4d542f3125458f3a81af210d901dcd7411efd" -dependencies = [ - "itoa", - "serde", - "time-core", - "time-macros", -] - -[[package]] -name = "time-core" -version = "0.1.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7300fbefb4dadc1af235a9cef3737cea692a9d97e1b9cbcd4ebdae6f8868e6fb" - -[[package]] -name = "time-macros" -version = "0.2.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "372950940a5f07bf38dbe211d7283c9e6d7327df53794992d293e534c733d09b" -dependencies = [ - "time-core", -] - -[[package]] -name = "tinyvec" -version = "1.6.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "87cc5ceb3875bb20c2890005a4e226a4651264a5c75edb2421b52861a0a0cb50" -dependencies = [ - "tinyvec_macros", -] - -[[package]] -name = "tinyvec_macros" -version = "0.1.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20" - -[[package]] -name = "tokio" -version = "1.28.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "94d7b1cfd2aa4011f2de74c2c4c63665e27a71006b0a192dcd2710272e73dfa2" -dependencies = [ - "autocfg", - "bytes", - "libc", - "mio", - "parking_lot", - "pin-project-lite", - "signal-hook-registry", - "socket2", - "windows-sys", -] - -[[package]] -name = "tokio-util" -version = "0.7.8" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "806fe8c2c87eccc8b3267cbae29ed3ab2d0bd37fca70ab622e46aaa9375ddb7d" -dependencies = [ - "bytes", - "futures-core", - "futures-sink", - "pin-project-lite", - "tokio", - "tracing", -] - -[[package]] -name = "toml" -version = "0.5.11" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f4f7f0dd8d50a853a531c426359045b1998f04219d88799810762cd4ad314234" -dependencies = [ - "serde", -] - -[[package]] -name = "tracing" -version = "0.1.37" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8ce8c33a8d48bd45d624a6e523445fd21ec13d3653cd51f681abf67418f54eb8" -dependencies = [ - "cfg-if", - "log", - "pin-project-lite", - "tracing-core", -] - -[[package]] -name = "tracing-core" -version = "0.1.31" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0955b8137a1df6f1a2e9a37d8a6656291ff0297c1a97c24e0d8425fe2312f79a" -dependencies = [ - "once_cell", -] - -[[package]] -name = "typenum" -version = "1.16.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "497961ef93d974e23eb6f433eb5fe1b7930b659f06d12dec6fc44a8f554c0bba" - -[[package]] -name = "unicode-bidi" -version = "0.3.13" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "92888ba5573ff080736b3648696b70cafad7d250551175acbaa4e0385b3e1460" - -[[package]] -name = "unicode-ident" -version = "1.0.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b15811caf2415fb889178633e7724bad2509101cde276048e013b9def5e51fa0" - -[[package]] -name = "unicode-normalization" -version = "0.1.22" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5c5713f0fc4b5db668a2ac63cdb7bb4469d8c9fed047b1d0292cc7b0ce2ba921" -dependencies = [ - "tinyvec", -] - -[[package]] -name = "uom" -version = "0.30.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "e76503e636584f1e10b9b3b9498538279561adcef5412927ba00c2b32c4ce5ed" -dependencies = [ - "num-traits", - "typenum", -] - -[[package]] -name = "url" -version = "2.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "50bff7831e19200a85b17131d085c25d7811bc4e186efdaf54bbd132994a88cb" -dependencies = [ - "form_urlencoded", - "idna", - "percent-encoding", -] - -[[package]] -name = "vcpkg" -version = "0.2.15" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "accd4ea62f7bb7a82fe23066fb0957d48ef677f6eeb8215f372f52e48bb32426" - -[[package]] -name = "vergen" -version = "8.2.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "8b3c89c2c7e50f33e4d35527e5bf9c11d6d132226dbbd1753f0fbe9f19ef88c6" -dependencies = [ - "anyhow", - "rustc_version", - "rustversion", - "sysinfo", - "time", -] - -[[package]] -name = "version_check" -version = "0.9.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "49874b5167b65d7193b8aba1567f5c7d93d001cafc34600cee003eda787e483f" - -[[package]] -name = "wasi" -version = "0.11.0+wasi-snapshot-preview1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423" - -[[package]] -name = "winapi" -version = "0.3.9" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419" -dependencies = [ - "winapi-i686-pc-windows-gnu", - "winapi-x86_64-pc-windows-gnu", -] - -[[package]] -name = "winapi-i686-pc-windows-gnu" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6" - -[[package]] -name = "winapi-util" -version = "0.1.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "70ec6ce85bb158151cae5e5c87f95a8e97d2c0c4b001223f33a334e3ce5de178" -dependencies = [ - "winapi", -] - -[[package]] -name = "winapi-x86_64-pc-windows-gnu" -version = "0.4.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f" - -[[package]] -name = "windows-sys" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9" -dependencies = [ - "windows-targets", -] - -[[package]] -name = "windows-targets" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7b1eb6f0cd7c80c79759c929114ef071b87354ce476d9d94271031c0497adfd5" -dependencies = [ - "windows_aarch64_gnullvm", - "windows_aarch64_msvc", - "windows_i686_gnu", - "windows_i686_msvc", - "windows_x86_64_gnu", - "windows_x86_64_gnullvm", - "windows_x86_64_msvc", -] - -[[package]] -name = "windows_aarch64_gnullvm" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "91ae572e1b79dba883e0d315474df7305d12f569b400fcf90581b06062f7e1bc" - -[[package]] -name = "windows_aarch64_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b2ef27e0d7bdfcfc7b868b317c1d32c641a6fe4629c171b8928c7b08d98d7cf3" - -[[package]] -name = "windows_i686_gnu" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "622a1962a7db830d6fd0a69683c80a18fda201879f0f447f065a3b7467daa241" - -[[package]] -name = "windows_i686_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "4542c6e364ce21bf45d69fdd2a8e455fa38d316158cfd43b3ac1c5b1b19f8e00" - -[[package]] -name = "windows_x86_64_gnu" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ca2b8a661f7628cbd23440e50b05d705db3686f894fc9580820623656af974b1" - -[[package]] -name = "windows_x86_64_gnullvm" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7896dbc1f41e08872e9d5e8f8baa8fdd2677f29468c4e156210174edc7f7b953" - -[[package]] -name = "windows_x86_64_msvc" -version = "0.48.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1a515f5799fe4961cb532f983ce2b23082366b898e52ffbce459c86f67c8378a" - -[[package]] -name = "winres" -version = "0.1.12" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b68db261ef59e9e52806f688020631e987592bd83619edccda9c47d42cde4f6c" -dependencies = [ - "toml", -] - -[[package]] -name = "zstd" -version = "0.12.3+zstd.1.5.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "76eea132fb024e0e13fd9c2f5d5d595d8a967aa72382ac2f9d39fcc95afd0806" -dependencies = [ - "zstd-safe", -] - -[[package]] -name = "zstd-safe" -version = "6.0.5+zstd.1.5.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d56d9e60b4b1758206c238a10165fbcae3ca37b01744e394c463463f6529d23b" -dependencies = [ - "libc", - "zstd-sys", -] - -[[package]] -name = "zstd-sys" -version = "2.0.8+zstd.1.5.5" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5556e6ee25d32df2586c098bbfa278803692a20d0ab9565e049480d52707ec8c" -dependencies = [ - "cc", - "libc", - "pkg-config", -] diff --git a/Cargo.toml b/Cargo.toml deleted file mode 100644 index 89fa8a5..0000000 --- a/Cargo.toml +++ /dev/null @@ -1,42 +0,0 @@ -[package] -name = "harmony_link_server" -version = "0.2.0" -edition = "2021" -authors = ["Jordon jordon@jordongamedev.co.uk"] -homepage = "https://jordongamedev.co.uk" -repository = "https://github.com/Jordonbc/HarmonyLinkServer" -license = "GPL-3.0-or-later" - -# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html - -[profile.release] -panic = "abort" # Strip expensive panic clean-up logic -codegen-units = 1 # Compile crates one after another so the compiler can optimize better -lto = true # Enables link to optimizations -opt-level = "z" # Optimize for binary size -strip = true # Remove debug symbols - -[package.metadata.winres] -LegalCopyright = "Copyright © 2023 Jordon Brooks" -ProductName = "HarmonyLink: Server" -FileDescription = "Optimized games for your handheld!" - -[[bin]] -name = "harmony_link_server" -path = "src/main.rs" - -[build-dependencies] -vergen = { version = "8.2.1", features = ["build", "cargo", "git", "gitcl", "rustc", "si"] } -winres = "0.1.12" - -[dependencies] -actix-web = "4.3.1" -env_logger = "0.10.0" -log = "0.4.18" -serde = {version = "1.0.163", features = ["derive"]} -serde_json = "1.0.96" -sysinfo = "0.29.0" -os_info = "3.0" -battery = "0.7.8" -lazy_static = "1.4.0" -rusb = "0.9.2" diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt new file mode 100644 index 0000000..8412f45 --- /dev/null +++ b/HarmonyLinkLib/CMakeLists.txt @@ -0,0 +1,129 @@ +cmake_minimum_required(VERSION 3.10) +project(HarmonyLinkLib VERSION 2.0.0) + +# Find the current Git branch and the last commit timestamp +find_package(Git QUIET) +if(GIT_FOUND) + execute_process( + COMMAND ${GIT_EXECUTABLE} rev-parse --abbrev-ref HEAD + WORKING_DIRECTORY ${CMAKE_SOURCE_DIR} + OUTPUT_VARIABLE GIT_BRANCH_NAME + OUTPUT_STRIP_TRAILING_WHITESPACE + ) + execute_process( + COMMAND ${GIT_EXECUTABLE} log -1 --format=%ct + WORKING_DIRECTORY ${CMAKE_SOURCE_DIR} + OUTPUT_VARIABLE GIT_COMMIT_TIMESTAMP + OUTPUT_STRIP_TRAILING_WHITESPACE + ) +else() + set(GIT_BRANCH_NAME "Unknown") + set(GIT_COMMIT_TIMESTAMP "Unknown") +endif() + +configure_file(include/Version.h.in Version.generated.h) + +# Specify the C++ standard +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED True) + +# Explicitly list source files +set(COMMON_SOURCES + "src/Platform/IPlatformUtilities.cpp" + "src/HarmonyLinkLib.cpp" + "src/Version.cpp" + "src/dllmain.cpp" + "src/Platform/WineUtilities.cpp" +) + +# Explicitly list include files +set(COMMON_INCLUDES + "include/Core.h" + "include/Structs/FBattery.h" + "include/Structs/FOSVerInfo.h" + "include/Structs/FDevice.h" + "include/Structs/FCPUInfo.h" + + "include/Enums/EDevice.h" + "include/Enums/EPlatform.h" + + "include/FString.h" + "include/HarmonyLinkLib.h" + "include/Version.h" + + "src/Platform/IPlatformUtilities.h" + "src/Platform/WineUtilities.h" +) + +set(WINDOWS_SOURCES + "src/Platform/Windows/WindowsUtilities.cpp" +) + +set(WINDOWS_INCLUDES + "src/Platform/Windows/WindowsUtilities.h" +) + +set(LINUX_SOURCES + "src/Platform/Unix/Linux/LinuxUtilities.cpp" + "src/Platform/Unix/UnixUtilities.cpp" +) + +set(LINUX_INCLUDES + "src/Platform/Unix/Linux/LinuxUtilities.h" + "src/Platform/Unix/UnixUtilities.h" +) + +set(MAC_SOURCES + "src/Platform/Unix/Mac/MacUtilities.cpp" + "src/Platform/Unix/UnixUtilities.cpp" +) + +set(MAC_INCLUDES + "src/Platform/Unix/Mac/MacUtilities.h" + "src/Platform/Unix/UnixUtilities.h" +) + +# Platform-specific definitions +if(WIN32) + message(STATUS "Compiling for Windows...") + list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${WINDOWS_SOURCES}) + list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${WINDOWS_INCLUDES}) +elseif(UNIX) + message(STATUS "Compiling for Unix-based systems...") + if(APPLE) + message(STATUS "Compiling for Mac...") + list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${MAC_SOURCES}) + list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${MAC_INCLUDES}) + else() + message(STATUS "Compiling for Linux...") + list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${LINUX_SOURCES}) + list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${LINUX_INCLUDES}) + endif() +endif() + +# Add library +add_library(HarmonyLinkLib SHARED ${LIB_SOURCES} ${LIB_INCLUDES}) + +target_include_directories(HarmonyLinkLib + PRIVATE + "${PROJECT_SOURCE_DIR}/src" + PUBLIC + "${PROJECT_BINARY_DIR}" + "${PROJECT_SOURCE_DIR}/include" +) + +target_compile_definitions(HarmonyLinkLib PRIVATE HARMONYLINKLIB_EXPORTS) + +if(CMAKE_BUILD_TYPE STREQUAL "Debug") + target_compile_definitions(HarmonyLinkLib PRIVATE "DEBUG_MODE") +endif() + +# Set output directories for all build types +foreach(TYPE IN ITEMS DEBUG RELEASE) + string(TOUPPER ${TYPE} TYPE_UPPER) + set_target_properties(${PROJECT_NAME} PROPERTIES + RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" + LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/${PROJECT_NAME}" + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/${PROJECT_NAME}" + ) +endforeach() diff --git a/HarmonyLinkLib/include/Core.h b/HarmonyLinkLib/include/Core.h new file mode 100644 index 0000000..90d63b4 --- /dev/null +++ b/HarmonyLinkLib/include/Core.h @@ -0,0 +1,14 @@ +// Copyright (C) 2023 Jordon Brooks + +#pragma once + +// Use a preprocessor definition to switch between export and import declarations +#ifdef _WIN32 + #ifdef HARMONYLINKLIB_EXPORTS + #define HARMONYLINKLIB_API __declspec(dllexport) + #else + #define HARMONYLINKLIB_API __declspec(dllimport) + #endif +#else + #define HARMONYLINKLIB_API +#endif diff --git a/HarmonyLinkLib/include/Enums/EDevice.h b/HarmonyLinkLib/include/Enums/EDevice.h new file mode 100644 index 0000000..75d3cc5 --- /dev/null +++ b/HarmonyLinkLib/include/Enums/EDevice.h @@ -0,0 +1,19 @@ +#pragma once + +#include + +// Enum class for representing different types of devices +namespace HarmonyLinkLib +{ + enum class EDevice : uint8_t + { + DESKTOP, + LAPTOP, + HANDHELD, + + STEAM_DECK, + // ROG_ALLY + // AYONEO_SLIDE + // etc... + }; +} diff --git a/HarmonyLinkLib/include/Enums/EPlatform.h b/HarmonyLinkLib/include/Enums/EPlatform.h new file mode 100644 index 0000000..c050ca3 --- /dev/null +++ b/HarmonyLinkLib/include/Enums/EPlatform.h @@ -0,0 +1,15 @@ +#pragma once + +#include + +// Enum class for representing different operating platforms +namespace HarmonyLinkLib +{ + enum class EPlatform : uint8_t + { + WINDOWS, + LINUX, + MAC, + UNIX, + }; +} diff --git a/HarmonyLinkLib/include/FString.h b/HarmonyLinkLib/include/FString.h new file mode 100644 index 0000000..3f23dc1 --- /dev/null +++ b/HarmonyLinkLib/include/FString.h @@ -0,0 +1,165 @@ +// Copyright (C) 2024 Jordon Brooks + +#pragma once + +#include +#include +#include + +#include "Core.h" // Replace with actual API export macro + +/** + * @file FString.h + * @brief FString Class - Custom String Management for DLL Export + * + * The FString class is a custom string management class designed to safely encapsulate + * string handling and memory management, especially for use in DLLs (Dynamic Link Libraries). + * It resolves the common issue of exporting classes containing standard library types, + * such as std::string, across DLL boundaries, which can lead to compiler warnings or errors. + * + * Features: + * - Implements basic string operations such as construction, destruction, copy, and move semantics. + * - Utilizes smart pointers (std::unique_ptr) for automatic memory management, reducing the risk of memory leaks. + * - Provides a simple interface for interacting with character strings, similar to std::string. + * - Includes both deep copy semantics for safety and move semantics for performance in object transfers. + * + * Usage: + * FString can be used as a safer alternative to std::string for classes that are exported from a DLL. + * It handles memory allocation/deallocation automatically and provides a basic set of string operations. + * + * Example: + * FString myString("Hello, world!"); + * std::cout << myString.c_str() << std::endl; // Output: Hello, world! + * + * Note: + * - The class is currently designed with basic functionality. Additional features such as + * string concatenation, substring, and comparison operations can be added as needed. + * - Ensure that the HarmonyLinkLibApi.h (or equivalent) file correctly defines the export macro + * for DLL usage. + * + */ + namespace HarmonyLinkLib + { + class HARMONYLINKLIB_API FString { + public: + FString() : data_(new char[1]) { + data_[0] = '\0'; + } + + FString(const char* str) { + const size_t len = strlen(str); + data_ = new char[len + 1]; + memcpy(data_, str, len + 1); + } + + // Copy constructor + FString(const FString& other) { + const size_t len = strlen(other.data_); + data_ = new char[len + 1]; + memcpy(data_, other.data_, len + 1); + } + + ~FString() { + delete[] data_; + } + + // Copy assignment operator + FString& operator=(const FString& other) { + if (this != &other) { + delete[] data_; + const size_t len = strlen(other.data_); + data_ = new char[len + 1]; + memcpy(data_, other.data_, len + 1); + } + return *this; + } + + // Concatenation operator for FString objects + FString operator+(const FString& other) const { + size_t thisLen = strlen(this->data_); + size_t otherLen = strlen(other.data_); + char* concatenated = new char[thisLen + otherLen + 1]; + + memcpy(concatenated, this->data_, thisLen); + memcpy(concatenated + thisLen, other.data_, otherLen + 1); + + FString result(concatenated); + delete[] concatenated; + return result; + } + + // Concatenation operator for const char* + FString operator+(const char* other) const { + return *this + FString(other); + } + + // Friend function to allow concatenation with const char* on the left-hand side + friend FString operator+(const char* lhs, const FString& rhs) { + return FString(lhs) + rhs; + } + + // Move constructor + FString(FString&& other) noexcept : data_(other.data_) { + other.data_ = nullptr; + } + + FString(const std::string& str) { + const size_t len = str.length(); + data_ = new char[len + 1]; + memcpy(data_, str.c_str(), len + 1); + } + + // Move assignment operator + FString& operator=(FString&& other) noexcept { + if (this != &other) { + delete[] data_; + data_ = other.data_; + other.data_ = nullptr; + } + return *this; + } + + bool operator==(const FString& other) const { + return strcmp(data_, other.data_) == 0; + } + + // Method to get a lowercase version of the string + static FString to_lower(FString& from) + { + for (size_t i = 0; i < strlen(from.data_); ++i) { + from.data_[i] = static_cast(std::tolower(static_cast(from.data_[i]))); + } + return from; + } + + // Overloaded static method to handle const char* + static FString to_lower(const char* from) { + FString temp_string(from); // Create an FString from const char* + return to_lower(temp_string); // Reuse the existing to_lower method + } + + const char* c_str() const { + return data_; + } + + private: + char* data_ = nullptr; + }; + } + +namespace std { + template<> + struct hash { + size_t operator()(const HarmonyLinkLib::FString& s) const { + size_t hashValue = 5381; // Starting value recommended by the djb2 algorithm + const char* str = s.c_str(); + + for (size_t i = 0; str[i] != '\0'; ++i) { + hashValue = ((hashValue << 5) + hashValue) + static_cast(str[i]); + // Equivalent to hashValue * 33 + str[i] + } + + return hashValue; + } + }; +} diff --git a/HarmonyLinkLib/include/HarmonyLinkLib.h b/HarmonyLinkLib/include/HarmonyLinkLib.h new file mode 100644 index 0000000..abd095e --- /dev/null +++ b/HarmonyLinkLib/include/HarmonyLinkLib.h @@ -0,0 +1,44 @@ +// Copyright (C) 2023 Jordon Brooks + + +/** + * IMPORTANT REMINDER: + * Do NOT use standard output functions like std::cout and printf anywhere in this codebase. + * + * Reason: + * Unreal Engine 5's packaging tool encounters issues with these functions, leading to + * packaging failures. The engine sets stdout to UTF-8, which can cause conflicts with + * these standard functions, resulting in a "SECURE CRT: Invalid parameter detected" error + * during packaging. + * + * This issue once required an extensive debugging effort that lasted over 8 hours. + * To prevent similar issues in the future and ensure smooth packaging, always use + * wide-character versions of these functions, such as wprintf and std::wcout, when working + * within the DLL. These functions are compatible with the UTF-8 setting in Unreal Engine 5. + * + */ + + +#pragma once + +#include "Core.h" +#include "Structs/FBattery.h" +#include "Structs/FCPUInfo.h" +#include "Structs/FDevice.h" +#include "Structs/FOSVerInfo.h" + + +class IPlatformUtilities; + +namespace HarmonyLinkLib +{ + extern "C" HARMONYLINKLIB_API bool get_is_wine(); + + extern "C" HARMONYLINKLIB_API FCPUInfo* get_cpu_info(); + + extern "C" HARMONYLINKLIB_API FDevice* get_device_info(); + + extern "C" HARMONYLINKLIB_API FOSVerInfo* get_os_version(); + + extern "C" HARMONYLINKLIB_API FBattery* get_battery_status(); +} diff --git a/HarmonyLinkLib/include/HarmonyLinkStruct.h b/HarmonyLinkLib/include/HarmonyLinkStruct.h new file mode 100644 index 0000000..aa4497d --- /dev/null +++ b/HarmonyLinkLib/include/HarmonyLinkStruct.h @@ -0,0 +1,13 @@ +#pragma once + +struct HarmonyLinkStruct +{ + // Virtual destructor is important for proper cleanup of derived types + virtual ~HarmonyLinkStruct() = default; + + // Method to deallocate the object + void free() const + { + delete this; + } +}; diff --git a/HarmonyLinkLib/include/Structs/FBattery.h b/HarmonyLinkLib/include/Structs/FBattery.h new file mode 100644 index 0000000..6c41595 --- /dev/null +++ b/HarmonyLinkLib/include/Structs/FBattery.h @@ -0,0 +1,22 @@ +#pragma once + +#include +#include + +#include "HarmonyLinkStruct.h" + +namespace HarmonyLinkLib +{ + struct FBattery : HarmonyLinkStruct + { + bool has_battery; + bool is_connected_to_ac; + uint8_t battery_percent; + + void to_string() const { + std::wcout << "Battery present: " << (has_battery ? "'Yes'" : "'No'") << '\n'; + std::wcout << "Connected to AC: " << (is_connected_to_ac ? "'Yes'" : "'No'") << '\n'; + std::wcout << "Battery percent: '" << static_cast(battery_percent) << "%'" << '\n'; + } + }; +} diff --git a/HarmonyLinkLib/include/Structs/FCPUInfo.h b/HarmonyLinkLib/include/Structs/FCPUInfo.h new file mode 100644 index 0000000..8694e6a --- /dev/null +++ b/HarmonyLinkLib/include/Structs/FCPUInfo.h @@ -0,0 +1,40 @@ +#pragma once + +#include +#include +#include "FString.h" + +#include "HarmonyLinkStruct.h" + +namespace HarmonyLinkLib +{ + struct FCPUInfo : HarmonyLinkStruct + { + FString VendorID; + FString Model_Name; + uint32_t Physical_Cores = 0; + uint32_t Logical_Cores = 0; + std::unordered_set Flags; + + void print() const + { + wprintf(L"VendorID: '%hs'\n", VendorID.c_str()); + wprintf(L"Model_Name: '%hs'\n", Model_Name.c_str()); + wprintf(L"Physical_Cores: '%d'\n", Physical_Cores); + wprintf(L"Logical_Cores: '%d'\n", Logical_Cores); + + // Initialize a string to hold all flags + std::string allFlags; + for (const auto& flag : Flags) { + allFlags += std::string(flag.c_str()) + " "; // Append each flag followed by a space + } + + // Remove the trailing space + if (!allFlags.empty()) { + allFlags.pop_back(); + } + + wprintf(L"Flags: '%hs'\n", allFlags.c_str()); + } + }; +} diff --git a/HarmonyLinkLib/include/Structs/FDevice.h b/HarmonyLinkLib/include/Structs/FDevice.h new file mode 100644 index 0000000..204a5da --- /dev/null +++ b/HarmonyLinkLib/include/Structs/FDevice.h @@ -0,0 +1,16 @@ +#pragma once + +#include + +#include "Enums/EDevice.h" +#include "Enums/EPlatform.h" + +namespace HarmonyLinkLib +{ + // Struct to represent a specific device with both platform and device type + struct FDevice : HarmonyLinkStruct + { + EPlatform platform; + EDevice device; + }; +} diff --git a/HarmonyLinkLib/include/Structs/FOSVerInfo.h b/HarmonyLinkLib/include/Structs/FOSVerInfo.h new file mode 100644 index 0000000..6b62db3 --- /dev/null +++ b/HarmonyLinkLib/include/Structs/FOSVerInfo.h @@ -0,0 +1,50 @@ +#pragma once + +#include "FString.h" +#include "HarmonyLinkStruct.h" + +namespace HarmonyLinkLib +{ + struct FOSVerInfo : HarmonyLinkStruct { + // 'name' represents the operating system's name, e.g., "Ubuntu" in Linux or "Windows" in Windows systems. + FString name; + + // 'version' is a numerical representation of the OS version. In Linux, it might be the kernel version, + // whereas in Windows, it could be the major version number like 10 for Windows 10. + uint32_t version = 0; + + // 'id' is a unique identifier for the OS. In Linux, it might be a lower-case string like "ubuntu". + // In Windows, this could map to the edition ID, such as "Professional". + FString id; + + // 'version_id' is a string representing the specific version of the OS. + // For example, "20.04" in Ubuntu or "1909" in Windows 10. + FString version_id; + + // 'version_codename' is a codename for the OS version, if available. + // This is common in Linux distributions (e.g., "focal" for Ubuntu 20.04) but not typically used in Windows. + FString version_codename; + + // 'pretty_name' is a more readable version of the name, potentially including the version and codename. + // For example, "Ubuntu 20.04 LTS (Focal Fossa)" or "Windows 10 Pro". + FString pretty_name; + + // 'variant_id' is an identifier for the specific variant of the OS, if available. + // For example, in Linux distributions, this might be "desktop" for the desktop edition, + // "server" for the server edition, or "core" for a minimal installation. It helps distinguish + // between different flavors or editions of the same version. + // On the Steam Deck, this is set to "steamdeck". + FString variant_id; + + void print() const + { + wprintf(L"Name: '%hs'\n", name.c_str()); + wprintf(L"Version: '%d'\n", version); + wprintf(L"ID: '%hs'\n", id.c_str()); + wprintf(L"Version ID: '%hs'\n", version_id.c_str()); + wprintf(L"Version Codename: '%hs'\n", version_codename.c_str()); + wprintf(L"Pretty Name: '%hs'\n", pretty_name.c_str()); + wprintf(L"Variant ID: '%hs'\n", variant_id.c_str()); + } +}; +} diff --git a/HarmonyLinkLib/include/Version.h b/HarmonyLinkLib/include/Version.h new file mode 100644 index 0000000..61d6e3f --- /dev/null +++ b/HarmonyLinkLib/include/Version.h @@ -0,0 +1,45 @@ +// Copyright (C) 2024 Jordon Brooks +#pragma once + +#include "Core.h" +#include + +#include "FString.h" + +namespace HarmonyLinkLib +{ + class HARMONYLINKLIB_API version + { + public: + version() = default; + + static FString ToString() + { + return HARMONYLINK_VERSION; + } + + static FString get_build_timestamp() + { + return {__TIMESTAMP__}; + } + + static FString get_git_branch() + { + return {GIT_BRANCH_NAME}; + } + + static FString get_git_commit_timestamp() + { + return {GIT_COMMIT_TIMESTAMP}; + } + + static bool is_debug() + { +#ifdef DEBUG_MODE + return true; +#else + return false; +#endif + } + }; +} diff --git a/HarmonyLinkLib/include/Version.h.in b/HarmonyLinkLib/include/Version.h.in new file mode 100644 index 0000000..4081f8d --- /dev/null +++ b/HarmonyLinkLib/include/Version.h.in @@ -0,0 +1,11 @@ +// Version.h.in +#pragma once + +#define HARMONYLINK_VERSION_MAJOR @HarmonyLinkLib_VERSION_MAJOR@ +#define HARMONYLINK_VERSION_MINOR @HarmonyLinkLib_VERSION_MINOR@ +#define HARMONYLINK_VERSION_PATCH @HarmonyLinkLib_VERSION_PATCH@ +#define HARMONYLINK_VERSION_TWEAK @HarmonyLinkLib_VERSION_TWEAK@ +#define HARMONYLINK_VERSION "@HarmonyLinkLib_VERSION@" + +#define GIT_BRANCH_NAME "@GIT_BRANCH_NAME@" +#define GIT_COMMIT_TIMESTAMP "@GIT_COMMIT_TIMESTAMP@" diff --git a/HarmonyLinkLib/src/HarmonyLinkLib.cpp b/HarmonyLinkLib/src/HarmonyLinkLib.cpp new file mode 100644 index 0000000..d3f0bc2 --- /dev/null +++ b/HarmonyLinkLib/src/HarmonyLinkLib.cpp @@ -0,0 +1,94 @@ +#include "HarmonyLinkLib.h" + +#include +#include "Platform/IPlatformUtilities.h" + +namespace HarmonyLinkLib +{ + std::shared_ptr PlatformUtilities = IPlatformUtilities::GetInstance(); + + bool get_is_wine() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return false; + } + + return PlatformUtilities->is_running_under_wine(); + } + + FCPUInfo* get_cpu_info() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return nullptr; + } + + const std::shared_ptr cpu_info = PlatformUtilities->get_cpu_info(); + if (!cpu_info) + { + return nullptr; + } + + FCPUInfo* new_cpu_info = new FCPUInfo(*cpu_info); + return new_cpu_info; + } + + FDevice* get_device_info() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return nullptr; + } + + const std::shared_ptr device = PlatformUtilities->get_device(); + if (!device) + { + return nullptr; + } + + FDevice* new_device = new FDevice(*device); + return new_device; + } + + FOSVerInfo* get_os_version() + { + + + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return nullptr; + } + + const std::shared_ptr os_version_info = PlatformUtilities->get_os_version(); + if (!os_version_info) + { + return nullptr; + } + + FOSVerInfo* new_os_info = new FOSVerInfo(*os_version_info); + return new_os_info; + } + + FBattery* get_battery_status() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return nullptr; + } + + const std::shared_ptr new_battery = PlatformUtilities->get_battery_status(); + if (!new_battery) + { + return nullptr; + } + + FBattery* battery = new FBattery(*new_battery); + return battery; + } +} diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp new file mode 100644 index 0000000..44d6e80 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -0,0 +1,122 @@ +#include "IPlatformUtilities.h" + +#include + +#include "WineUtilities.h" +#if BUILD_WINDOWS +#include "Windows/WindowsUtilities.h" +#elif BUILD_LINUX +#include "Unix/Linux/LinuxUtilities.h" +#elif BUILD_MAC +#include "Unix/Mac/MacUtilities.h" +#elif BUILD_UNIX +#include "Unix/Mac/MacUtilities.h" +#endif + +namespace HarmonyLinkLib +{ + static std::shared_ptr INSTANCE = nullptr; + +std::shared_ptr& IPlatformUtilities::GetInstance() +{ + if (!INSTANCE) + { +#if BUILD_WINDOWS + INSTANCE = std::make_shared(); +#elif BUILD_LINUX + INSTANCE = std::make_shared(); +#elif BUILD_MAC + INSTANCE = std::make_shared(); +#elif BUILD_UNIX + INSTANCE = std::make_shared(); +// ... other platform checks +#else + std::wcout << "Platform is not supported.\n" +#endif + } + + return INSTANCE; +} + +bool IPlatformUtilities::is_running_under_wine() +{ + return WineUtilities::is_wine_present(); +} + +bool IPlatformUtilities::is_linux() +{ +#ifdef BUILD_LINUX + return true; +#else + return is_running_under_wine(); +#endif +} + +std::shared_ptr IPlatformUtilities::get_device() +{ + FDevice new_device; + + if (is_linux()) + { + new_device.platform = EPlatform::LINUX; + } + else + { + new_device.platform = EPlatform::WINDOWS; + } + + const std::shared_ptr battery_status = get_battery_status(); + + if (battery_status && !battery_status->has_battery) + { + new_device.device = EDevice::DESKTOP; + } + else + { + new_device.device = EDevice::LAPTOP; + } + + if (is_steam_deck(new_device)) { + new_device.device = EDevice::STEAM_DECK; + } + return std::make_shared(new_device); +} + +// Helper function to check if the device is a Steam Deck +bool IPlatformUtilities::is_steam_deck(const FDevice& device) { + + // Check if the device is already identified as a Steam Deck + if (device.device == EDevice::STEAM_DECK) { + return true; + } + + // Check for Steam Deck by OS version + if (const std::shared_ptr version = get_os_version()) { + if (version->variant_id == "steamdeck" && version->name == "SteamOS") { + return true; + } + } else { + wprintf(L"OS version information not available.\n"); + } + + // Set of known Steam Deck CPU model names + const std::set steam_deck_models = {"amd custom apu 0405" /*, other models... */}; + + // Check for Steam Deck by CPU model name + if (const std::shared_ptr cpu_info = get_cpu_info()) { + const FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); + for (const auto& model : steam_deck_models) { + if (cpu_model_lower == model) { + wprintf(L"Steam Deck detected by CPU model name.\n"); + return true; + } + } + } else { + wprintf(L"CPU information not available.\n"); + } + + wprintf(L"Device is not a Steam Deck.\n"); + + return false; +} +} diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h new file mode 100644 index 0000000..b3d55da --- /dev/null +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h @@ -0,0 +1,34 @@ +#pragma once + +#include "Structs/FBattery.h" +#include "Structs/FCPUInfo.h" +#include "Structs/FDevice.h" +#include "Structs/FOSVerInfo.h" + +namespace HarmonyLinkLib +{ + class IPlatformUtilities { + public: + static std::shared_ptr& GetInstance(); + + IPlatformUtilities() = default; + IPlatformUtilities(const IPlatformUtilities& other) = default; + IPlatformUtilities(IPlatformUtilities&& other) = default; + IPlatformUtilities& operator=(const IPlatformUtilities& other) = default; + IPlatformUtilities& operator=(IPlatformUtilities&& other) = default; + virtual ~IPlatformUtilities() = default; + + // General OS-level functions + virtual bool is_running_under_wine(); + virtual bool is_linux(); + + virtual std::shared_ptr get_device(); + virtual std::shared_ptr get_cpu_info() = 0; + virtual std::shared_ptr get_battery_status() = 0; + virtual std::shared_ptr get_os_version() = 0; + + bool is_steam_deck(const FDevice& device); + + // Add more virtual functions for other OS interactions here + }; +} diff --git a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp new file mode 100644 index 0000000..fa7e4ff --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp @@ -0,0 +1,24 @@ +#include "LinuxUtilities.h" + + +#include +#include +#include "Platform/WineUtilities.h" + +namespace HarmonyLinkLib +{ + std::shared_ptr LinuxUtilities::get_battery_status() + { + return WineUtilities::get_battery_status(); + } + + std::shared_ptr LinuxUtilities::get_os_version() + { + return WineUtilities::get_linux_info(); + } + + std::shared_ptr LinuxUtilities::get_cpu_info() + { + return WineUtilities::get_cpu_info(); + } +} diff --git a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h new file mode 100644 index 0000000..6e7d780 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h @@ -0,0 +1,23 @@ +#pragma once + +#include "Structs/FOSVerInfo.h" + +#include "Platform/Unix/UnixUtilities.h" + +namespace HarmonyLinkLib +{ + class LinuxUtilities : public UnixUtilities { + public: + // Implementation for other Linux-specific functions + std::shared_ptr get_battery_status() override; + + std::shared_ptr get_os_version() override; + + std::shared_ptr get_cpu_info() override; + + bool is_linux() override + { + return true; + } + }; +} diff --git a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp new file mode 100644 index 0000000..2166845 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp @@ -0,0 +1,6 @@ +#include "MacUtilities.h" + +namespace HarmonyLinkLib +{ + +} \ No newline at end of file diff --git a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h new file mode 100644 index 0000000..e636401 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h @@ -0,0 +1,11 @@ +#pragma once + +#include "Platform/Unix/UnixUtilities.h" + +namespace HarmonyLinkLib +{ + class MacUtitities : public UnixUtilities { + public: + // Mac-specific overrides and additional functionality + }; +} diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp new file mode 100644 index 0000000..46ef352 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp @@ -0,0 +1,24 @@ +#include "UnixUtilities.h" + +namespace HarmonyLinkLib +{ + bool UnixUtilities::is_running_under_wine() + { + return false; + } + + std::shared_ptr UnixUtilities::get_cpu_info() + { + return nullptr; + } + + std::shared_ptr UnixUtilities::get_battery_status() + { + return nullptr; + } + + std::shared_ptr UnixUtilities::get_os_version() + { + return nullptr; + } +} \ No newline at end of file diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h new file mode 100644 index 0000000..b17e42e --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h @@ -0,0 +1,16 @@ +#pragma once + +#include "Platform/IPlatformUtilities.h" +namespace HarmonyLinkLib +{ + class UnixUtilities : public IPlatformUtilities { + public: + bool is_running_under_wine() override; + + std::shared_ptr get_cpu_info() override; + std::shared_ptr get_battery_status() override; + std::shared_ptr get_os_version() override; + + // Implementation for other Unix/Linux-specific functions + }; +} diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp new file mode 100644 index 0000000..4384a7a --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp @@ -0,0 +1,81 @@ +#include "WindowsUtilities.h" + +#include +#include + +#include "Platform/WineUtilities.h" + +namespace HarmonyLinkLib +{ + std::shared_ptr WindowsUtilities::get_battery_status() +{ + if (is_linux()) + { + return WineUtilities::get_battery_status(); + } + FBattery result; + + SYSTEM_POWER_STATUS status; + if (GetSystemPowerStatus(&status)) { + result.has_battery = status.BatteryFlag != 128; // 128 indicates no battery + result.is_connected_to_ac = status.ACLineStatus == 1; + result.battery_percent = result.has_battery ? status.BatteryLifePercent : 0; + } else { + std::wcout << "Failed to get power statistics.\n"; + } + + return std::make_shared(result); +} + +std::shared_ptr WindowsUtilities::get_cpu_info() +{ + if (is_linux()) + { + return WineUtilities::get_cpu_info(); + } + + return {}; +} + +std::shared_ptr WindowsUtilities::get_os_version() +{ + if (is_linux()) + { + return WineUtilities::get_linux_info(); + } + + OSVERSIONINFOEX os_version_info; + ZeroMemory(&os_version_info, sizeof(OSVERSIONINFOEX)); + os_version_info.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX); + + if (!GetVersionEx(reinterpret_cast(&os_version_info))) { + // Handle error if needed + return nullptr; + } + + FOSVerInfo os_version; + + HKEY h_key; + if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, TEXT("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion"), 0, KEY_READ, &h_key) == ERROR_SUCCESS) + { + DWORD dw_size; + DWORD dw_type; + char sz_product_name[256]; + dw_size = sizeof(sz_product_name); + if (RegQueryValueEx(h_key, TEXT("ProductName"), nullptr, &dw_type, reinterpret_cast(sz_product_name), &dw_size) == ERROR_SUCCESS) + { + os_version.pretty_name = sz_product_name; + } + RegCloseKey(h_key); + } + + std::stringstream version; + version << os_version_info.dwMajorVersion << "." << os_version_info.dwMinorVersion; + os_version.version_id = version.str(); + + os_version.name = "Windows"; + os_version.version = os_version_info.dwBuildNumber; // Build number as the version + + return std::make_shared(os_version); +} +} diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h new file mode 100644 index 0000000..849d269 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h @@ -0,0 +1,16 @@ +#pragma once + +#include "Platform/IPlatformUtilities.h" + +namespace HarmonyLinkLib +{ + class WindowsUtilities : public IPlatformUtilities + { + public: + std::shared_ptr get_battery_status() override; + + std::shared_ptr get_cpu_info() override; + + std::shared_ptr get_os_version() override; + }; +} diff --git a/HarmonyLinkLib/src/Platform/WineUtilities.cpp b/HarmonyLinkLib/src/Platform/WineUtilities.cpp new file mode 100644 index 0000000..3b420b1 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/WineUtilities.cpp @@ -0,0 +1,202 @@ +#include "WineUtilities.h" + +#include +#include +#include +#include +#include + +#ifdef BUILD_WINDOWS +#include +#endif + +namespace HarmonyLinkLib +{ + bool force_detect_wine = false; + + std::shared_ptr HarmonyLinkLib::WineUtilities::get_battery_status() + { + std::string append; + if (is_wine_present()) + { + append = "Z:"; + } + + FBattery result = {}; + for (int i = 0; i <= 9; ++i) { + if (std::string bat_path = append + "/sys/class/power_supply/BAT" + std::to_string(i); std::filesystem::exists(bat_path)) { + result.has_battery = true; + + std::ifstream status_file(bat_path + "/status"); + std::string status; + if (status_file.is_open() && std::getline(status_file, status)) { + if (status == "Charging" || status == "AC") { + result.is_connected_to_ac = true; + } + } + + std::ifstream capacity_file(bat_path + "/capacity"); + if (capacity_file.is_open() && std::getline(capacity_file, status)) { + result.battery_percent = static_cast(std::stoi(status)); + break; // assuming you only need data from the first battery found + } + } + } + + return std::make_shared(result); + } + + std::shared_ptr WineUtilities::get_cpu_info() + { + std::wcout << "Getting cpu info\n"; + + std::string append; + if (is_wine_present()) + { + append = "Z:"; + } + + FCPUInfo cpu_info; + + std::ifstream file(append + "/proc/cpuinfo"); + std::unordered_map hashmap; + + if (file) { + std::string line; + while (std::getline(file, line)) { + std::istringstream line_stream(line); + std::string key, value; + if (std::getline(line_stream, key, ':')) { + key.erase(key.find_last_not_of(" \t") + 1); // Trim trailing whitespace from key + if (std::getline(line_stream, value)) { + value.erase(0, value.find_first_not_of(" \t")); // Trim leading whitespace from value + + // Aggregate flags + if (key == "flags") { + std::istringstream flag_stream(value); + std::string flag; + while (flag_stream >> flag) { + flag.erase(flag.find_last_not_of(" \t") + 1); // Trim trailing whitespace from flag + cpu_info.Flags.insert(HarmonyLinkLib::FString(flag)); + //printf("Flag detected: %s\n", flag.c_str()); + } + } else { + hashmap[key] = value; + } + } + } + } + file.close(); + } + + // Now you can access the values using the keys: + cpu_info.VendorID = hashmap["vendor_id"]; + cpu_info.Model_Name = hashmap["model name"]; + + try { + cpu_info.Physical_Cores = std::stoi(hashmap["cpu cores"].c_str()); + } catch (const std::invalid_argument& ia) { + std::wcerr << "Invalid argument: " << ia.what() << '\n'; + } catch (const std::out_of_range& oor) { + std::wcerr << "Out of Range error: " << oor.what() << '\n'; + } + + cpu_info.Logical_Cores = (cpu_info.Flags.find("ht") != cpu_info.Flags.end()) ? cpu_info.Physical_Cores * 2 : cpu_info.Physical_Cores; + + return std::make_shared(cpu_info); + } + + std::shared_ptr WineUtilities::get_linux_info() + { + std::string append; + if (is_wine_present()) + { + append = "Z:"; + } + + FOSVerInfo os_info; + + std::ifstream file(append + "/etc/os-release"); + std::unordered_map hashmap; + + if (file) { + std::string line; + while (std::getline(file, line)) { + std::istringstream lineStream(line); + std::string key, value; + if (std::getline(lineStream, key, '=')) { + if (std::getline(lineStream, value)) { + // Remove leading and trailing whitespace + size_t firstNonSpace = value.find_first_not_of(" \t"); + size_t lastNonSpace = value.find_last_not_of(" \t"); + if (firstNonSpace != std::string::npos && lastNonSpace != std::string::npos) { + value = value.substr(firstNonSpace, lastNonSpace - firstNonSpace + 1); + } else { + value.clear(); // If value is all whitespace, make it empty + } + + // Check for double quotes and remove them + if (!value.empty() && value.front() == '"' && value.back() == '"') { + value = value.substr(1, value.length() - 2); + } + + hashmap[key] = value; + } + } + } + file.close(); + } + + // Now you can access the values using the keys: + os_info.name = hashmap["NAME"]; + os_info.id = hashmap["ID"]; + os_info.version_id = hashmap["VERSION_ID"]; + os_info.version_codename = hashmap["VERSION_CODENAME"]; + os_info.pretty_name = hashmap["PRETTY_NAME"]; + + try { + os_info.version = std::stoi(hashmap["VERSION"].c_str()); + } catch (const std::invalid_argument& ia) { + std::cerr << "Invalid argument: " << ia.what() << '\n'; + // Handle the error, perhaps by setting a default value or leaving the field unchanged + } catch (const std::out_of_range& oor) { + std::cerr << "Out of Range error: " << oor.what() << '\n'; + // Handle the error, perhaps by setting a default value or leaving the field unchanged + } + + return std::make_shared(os_info); + } + + bool WineUtilities::is_wine_present() + { + static bool isWineCached = false; // Static variable to store the cached result + static bool isWine = false; // Static variable to indicate if the caching has been done + + if (!isWineCached) + { + // Only detect wine if force_detect_wine is true or if we haven't cached the result yet +#ifdef BUILD_WINDOWS + std::wcout << "Detecting wine...\n"; + bool HasFound = GetProcAddress(GetModuleHandle("ntdll.dll"), "wine_get_version") != nullptr; + + if (!HasFound) + HasFound = GetProcAddress(GetModuleHandle("ntdll.dll"), "proton_get_version") != nullptr; + + wprintf(L"wine %s found\n", HasFound ? L"has been" : L"not"); + + isWine = HasFound; // Cache the result +#else + isWine = false; // In non-Windows builds, always set isWine to false +#endif + isWineCached = true; // Indicate that the result is now cached + } + + return isWine; // Return the cached result + } + + bool WineUtilities::force_detect_wine_presence() + { + force_detect_wine = true; + return is_wine_present(); + } +} diff --git a/HarmonyLinkLib/src/Platform/WineUtilities.h b/HarmonyLinkLib/src/Platform/WineUtilities.h new file mode 100644 index 0000000..33f2b30 --- /dev/null +++ b/HarmonyLinkLib/src/Platform/WineUtilities.h @@ -0,0 +1,46 @@ +#pragma once + +#include "Structs/FBattery.h" +#include "Structs/FCPUInfo.h" +#include "Structs/FOSVerInfo.h" + +namespace HarmonyLinkLib +{ + class WineUtilities + { + public: + static std::shared_ptr get_battery_status(); + + static std::shared_ptr get_cpu_info(); + + /** + * @brief Retrieves Linux OS version information from a specified file. + * + * This function parses a file (typically a Linux OS release file) at the given location + * to extract operating system version information. It reads key-value pairs from the file, + * processes them to handle whitespace and quotes, and then stores them in an FOSVerInfo + * structure. If the file location is invalid or the file cannot be opened, it returns an + * empty FOSVerInfo structure. Errors during parsing, such as invalid format or out of range + * values, are handled with exception catching. In Windows builds where Wine is detected, + * this function can use the file location 'Z:/etc/os-release' to retrieve the underlying + * Linux system information. + * + * @param file_location The location of the file containing OS version information. + * @return A shared pointer to a structure containing the parsed OS version information. + */ + static std::shared_ptr get_linux_info(); + + /** + * @brief Detects the presence of Wine or Proton in Windows builds. + * + * This function assesses if the application is running under Wine or Proton by + * querying specific functions in the 'ntdll.dll' module. It is only active in + * Windows builds, returning false for non-Windows builds. + * + * @return bool True if Wine or Proton is detected, false otherwise. + */ + static bool is_wine_present(); + + static bool force_detect_wine_presence(); + }; +} diff --git a/HarmonyLinkLib/src/Version.cpp b/HarmonyLinkLib/src/Version.cpp new file mode 100644 index 0000000..50b5049 --- /dev/null +++ b/HarmonyLinkLib/src/Version.cpp @@ -0,0 +1 @@ +#include "Version.h" diff --git a/HarmonyLinkLib/src/dllmain.cpp b/HarmonyLinkLib/src/dllmain.cpp new file mode 100644 index 0000000..a292db4 --- /dev/null +++ b/HarmonyLinkLib/src/dllmain.cpp @@ -0,0 +1,49 @@ +// Copyright (C) 2024 Jordon Brooks + +#include +#include "Version.h" + +namespace HarmonyLinkLib +{ + void HarmonyLinkInit() + { + std::wcout << "HarmonyLink V" << version::ToString().c_str() << " Copyright (C) 2023 Jordon Brooks\n"; + } +} + + +#if BUILD_WINDOWS +#include + +// Standard DLL entry point +BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) { + switch (fdwReason) { + case DLL_PROCESS_ATTACH: + // Code to run when the DLL is loaded + HarmonyLinkLib::HarmonyLinkInit(); + break; + case DLL_THREAD_ATTACH: + // Code to run when a thread is created during the DLL's lifetime + case DLL_THREAD_DETACH: + // Code to run when a thread ends normally. + case DLL_PROCESS_DETACH: + // Code to run when the DLL is unloaded + default: + break; + } + return TRUE; // Successful DLL_PROCESS_ATTACH. +} +#endif + +#if BUILD_UNIX +__attribute__((constructor)) +static void onLibraryLoad() { + // Code to run when the library is loaded + HarmonyLinkLib::HarmonyLinkInit(); +} + +__attribute__((destructor)) +static void onLibraryUnload() { + // Code to run when the library is unloaded +} +#endif diff --git a/HarmonyLinkTest/CMakeLists.txt b/HarmonyLinkTest/CMakeLists.txt new file mode 100644 index 0000000..5616a24 --- /dev/null +++ b/HarmonyLinkTest/CMakeLists.txt @@ -0,0 +1,31 @@ +cmake_minimum_required(VERSION 3.10) +project(HarmonyLinkTest) + +# Specify the C++ standard +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED True) + +# Automatically add all .cpp and .h/.hpp files in the src directory +file(GLOB_RECURSE TEST_SOURCES "src/*.cpp") +file(GLOB_RECURSE TEST_HEADERS "src/*.h" "src/*.hpp") + +# Add executable +add_executable(HarmonyLinkTest ${TEST_SOURCES} ${TEST_HEADERS}) + +# Link the HarmonyLinkLib with HarmonyLinkTest +target_link_libraries(HarmonyLinkTest PRIVATE HarmonyLinkLib) + +# Set output directories for all build types +foreach(TYPE IN ITEMS DEBUG RELEASE) + string(TOUPPER ${TYPE} TYPE_UPPER) + set_target_properties(${PROJECT_NAME} PROPERTIES + RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" + LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" + ) +endforeach() + +add_custom_command(TARGET HarmonyLinkTest POST_BUILD + COMMAND ${CMAKE_COMMAND} -E copy_if_different + "$" + "$") diff --git a/HarmonyLinkTest/src/main.cpp b/HarmonyLinkTest/src/main.cpp new file mode 100644 index 0000000..6b7ac05 --- /dev/null +++ b/HarmonyLinkTest/src/main.cpp @@ -0,0 +1,143 @@ +// Copyright (C) 2023 Jordon Brooks + +#include +#include +#include +#include + +#include "HarmonyLinkLib.h" + +// Include necessary headers for platform-specific functionality +#ifdef BUILD_WINDOWS +#include // For _kbhit() and _getch() +#include // For system("cls") +#else +#include // For read() +#include // For termios +#include // For getchar() +#include // For F_GETFL, F_SETFL and O_NONBLOCK +#endif + +std::atomic quitFlag(false); + +// Function to clear the screen cross-platform +void clearScreen() { +#ifdef _WIN32 + system("cls"); +#else + std::cout << "\x1B[2J\x1B[H"; +#endif +} + + +// Function to check if 'q' or 'Q' is pressed in Windows +void checkForQuit() { + while (!quitFlag) { +#ifdef BUILD_WINDOWS + if (_kbhit()) { + const char c = static_cast(_getch()); + if (c == 'q' || c == 'Q') { + quitFlag = true; + break; + } + } +#else + struct termios oldt, newt; + int ch; + int oldf; + + tcgetattr(STDIN_FILENO, &oldt); + newt = oldt; + newt.c_lflag &= ~(ICANON | ECHO); + tcsetattr(STDIN_FILENO, TCSANOW, &newt); + oldf = fcntl(STDIN_FILENO, F_GETFL, 0); + fcntl(STDIN_FILENO, F_SETFL, oldf | O_NONBLOCK); + + ch = getchar(); + + tcsetattr(STDIN_FILENO, TCSANOW, &oldt); + fcntl(STDIN_FILENO, F_SETFL, oldf); + + if (ch != EOF) { + ungetc(ch, stdin); + if (ch == 'q' || ch == 'Q') { + quitFlag = true; + break; + } + } +#endif + // Checks for input every roughly 60 frames + std::this_thread::sleep_for(std::chrono::milliseconds(16)); + } +} + +int main() +{ + std::cout << "Hello, World!" << '\n'; + + std::thread inputThread(checkForQuit); + + const bool isWine = HarmonyLinkLib::get_is_wine(); + const char* test = isWine ? "is" : "isn't"; + + const HarmonyLinkLib::FOSVerInfo* os_info = HarmonyLinkLib::get_os_version(); + + const HarmonyLinkLib::FDevice* device_info = HarmonyLinkLib::get_device_info(); + + const HarmonyLinkLib::FCPUInfo* cpu_info = HarmonyLinkLib::get_cpu_info(); + + // This loop is to test how stable & expensive these functions are + while (!quitFlag) + { + // Clear the screen + clearScreen(); + + std::wcout << "This program " << test << " running under wine.\n"; + + if (cpu_info) + { + cpu_info->print(); + } + + if (os_info) + { + os_info->print(); + } + + if (device_info) + { + wprintf(L"Is SteamDeck: %s\n", device_info->device == HarmonyLinkLib::EDevice::STEAM_DECK ? L"true" : L"false"); + } + + // we can't do this before the loop because we need updated values + if (const HarmonyLinkLib::FBattery* battery = HarmonyLinkLib::get_battery_status()) + { + battery->to_string(); + battery->free(); + } + + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + } + + if (inputThread.joinable()) + { + inputThread.join(); + } + + if (os_info) + { + os_info->free(); + } + + if (device_info) + { + device_info->free(); + } + + if (cpu_info) + { + cpu_info->free(); + } + + return 0; +} diff --git a/Resources/dock_models.json b/Resources/dock_models.json deleted file mode 100644 index 4da9504..0000000 --- a/Resources/dock_models.json +++ /dev/null @@ -1,11 +0,0 @@ -[ - { - "brand": "JSAUX", - "model": "HB0603", - "usb_ids": [ - [ 4826, 21521 ], - [ 4826, 1041 ], - [ 4826, 33139 ] - ] - } -] \ No newline at end of file diff --git a/build.rs b/build.rs deleted file mode 100644 index 0c857ec..0000000 --- a/build.rs +++ /dev/null @@ -1,72 +0,0 @@ -use std::env; -use std::error::Error; -use std::fs; -use std::path::Path; - -use vergen::EmitBuilder; - -fn copy_resources() -> Result<(), Box> { - // The directory of the Cargo manifest of the package that is currently being built. - let manifest_dir = env::var("CARGO_MANIFEST_DIR").expect("CARGO_MANIFEST_DIR is not defined"); - - // The directory where the final binaries will be placed. - let profile = env::var("PROFILE")?; - let out_dir = Path::new(&manifest_dir).join("target").join(profile).join("Resources"); - - if !out_dir.exists() { - fs::create_dir(&out_dir)?; - } - - // The Resources directory. - let resources_dir = Path::new(&manifest_dir).join("Resources"); - - // Ensure the Resources directory exists. - if !resources_dir.exists() { - panic!("Resources directory does not exist"); - } - - // Iterate over each entry in the Resources directory. - for entry in fs::read_dir(resources_dir)? { - let entry = entry?; - let path = entry.path(); - if path.is_file() { - // The destination path is the output directory plus the file name. - let dest_path = out_dir.join(path.file_name().expect("file has no name")); - // Copy the file. - fs::copy(&path, &dest_path)?; - } - } - - Ok(()) -} - -#[cfg(windows)] -fn windows_resource() -> Result<(), Box> { - let mut res = winres::WindowsResource::new(); - res.set_icon("res/HarmonyLinkLogo.ico"); - res.compile()?; - Ok(()) -} - -#[cfg(unix)] -fn windows_resource() -> Result<(), Box> { - Ok(()) -} - -fn main() -> Result<(), Box> { - // Emit the instructions - EmitBuilder::builder() - .all_build() - .all_cargo() - .all_git() - .all_rustc() - .all_sysinfo() - .emit()?; - - // Copy the Resources folder - copy_resources()?; - - windows_resource()?; - - Ok(()) -} diff --git a/src/api/api.rs b/src/api/api.rs deleted file mode 100644 index 1709874..0000000 --- a/src/api/api.rs +++ /dev/null @@ -1,14 +0,0 @@ -use actix_web::{HttpResponse, get, web}; - -use crate::version::info::Version; - -#[get("/supported_versions")] -pub async fn versions() -> HttpResponse { - let version = Version::get(); - HttpResponse::Ok().json(&version.supported_api_versions) -} - -pub fn configure(cfg: &mut web::ServiceConfig) { - cfg.service(versions); - // Register other version 1 handlers here... -} \ No newline at end of file diff --git a/src/api/endpoints_v1.rs b/src/api/endpoints_v1.rs deleted file mode 100644 index d055b7c..0000000 --- a/src/api/endpoints_v1.rs +++ /dev/null @@ -1,99 +0,0 @@ -use actix_web::web; -use actix_web::{HttpResponse, get}; - -use crate::v1::{docking, os, all_info, battery}; -use crate::version; - -#[get("/are_you_there")] -pub async fn heartbeat() -> HttpResponse { - HttpResponse::Ok().body("yes") -} - -#[get("/all_info")] -pub async fn get_all_info() -> HttpResponse { - match all_info::stats::get_all_info() { - Ok(info) => { - - #[cfg(debug_assertions)] - { - println!("Successfully got all info: {}", &info.clone().to_string()); - } - HttpResponse::Ok().json(&info) - }, - Err(err) => { - eprintln!("Failed to get all info: {}", err); - HttpResponse::InternalServerError().body(format!("Failed to get device info: {}", err)) - } - } -} - -#[get("/dock_info")] -pub async fn get_dock_info() -> HttpResponse { - match docking::stats::get_dock() { - Ok(info) => { - #[cfg(debug_assertions)] - { - println!("Successfully got dock info: {}", &info.clone().to_string()); - } - HttpResponse::Ok().json(&info) - }, - Err(err) => { - eprintln!("Failed to get dock info: {}", err); - HttpResponse::InternalServerError().body(format!("Failed to get dock info: {}", err)) - } - } -} - - -#[get("/os_info")] -pub async fn get_os_info() -> HttpResponse { - match os::stats::get_os() { - Ok(info) => { - #[cfg(debug_assertions)] - { - println!("Successfully got os info: {}", &info.clone().to_string()); - } - HttpResponse::Ok().json(&info) - }, - Err(err) => { - eprintln!("Failed to get os info: {}", err); - HttpResponse::InternalServerError().body(format!("Failed to get OS info: {}", err)) - } - } -} - -#[get("/battery_info")] -pub async fn get_battery_info() -> HttpResponse { - match battery::stats::get_battery_info() { - Ok(info) => { - #[cfg(debug_assertions)] - { - println!("Successfully got battery info: {}", &info.clone().to_string()); - } - HttpResponse::Ok().json(&info) - }, - Err(err) => { - eprintln!("Failed to get battery info: {}", err); - HttpResponse::InternalServerError().body(format!("Failed to get battery info: {}", err)) - } - } -} - -#[get("/version_info")] -pub async fn get_version_info() -> HttpResponse { - #[cfg(debug_assertions)] - { - println!("Successfully got version info: {}", version::info::Version::get().to_string()); - } - HttpResponse::Ok().json(&version::info::Version::get()) -} - -pub fn configure(cfg: &mut web::ServiceConfig) { - cfg.service(heartbeat); - cfg.service(get_all_info); - cfg.service(get_dock_info); - cfg.service(get_os_info); - cfg.service(get_battery_info); - cfg.service(get_version_info); - // Register other version 1 handlers here... -} \ No newline at end of file diff --git a/src/api/mod.rs b/src/api/mod.rs deleted file mode 100644 index e02bcc6..0000000 --- a/src/api/mod.rs +++ /dev/null @@ -1,3 +0,0 @@ -pub mod server; -mod endpoints_v1; -mod api; \ No newline at end of file diff --git a/src/api/server.rs b/src/api/server.rs deleted file mode 100644 index d9233f5..0000000 --- a/src/api/server.rs +++ /dev/null @@ -1,28 +0,0 @@ -use actix_web::{HttpServer, web}; - -use crate::api::endpoints_v1; -use crate::api::api; - -#[allow(dead_code)] -pub async fn stop_actix_web(server: actix_web::dev::Server) -> std::io::Result<()> { - println!("Stopping server."); - server.handle().stop(true).await; - Ok(()) -} - -pub fn start_actix_web(port: u16) -> std::io::Result { - - println!("Starting webserver on 127.0.0.1:{}", port); - - let server = HttpServer::new(move || { - let logger = actix_web::middleware::Logger::default(); - actix_web::App::new() - .wrap(logger) - .service(web::scope("/api").configure(api::configure)) - .service(web::scope("/v1").configure(endpoints_v1::configure)) - }) - .bind(("127.0.0.1", port))? - .run(); - - Ok(server) -} diff --git a/src/main.rs b/src/main.rs deleted file mode 100644 index ea17ce1..0000000 --- a/src/main.rs +++ /dev/null @@ -1,37 +0,0 @@ -mod v1; - -mod version; -use version::info::Version; - -mod api; - -static PORT: u16 = 9000; - -static USE_FALLBACK_DOCK_DETECTION: bool = false; - -fn main() { - - //#[cfg(debug_assertions)] - { - let version_info = Version::get(); - println!("Version: {}", version_info.version); - println!("Build Timestamp: {}", version_info.build_timestamp); - println!("Git Branch: {}", version_info.git_branch); - println!("Git Describe: {}", version_info.git_describe); - println!("Git Commit Timestamp: {}", version_info.git_commit_timestamp); - println!("Debug Build: {}", version_info.debug); - println!("API versions: {}", version_info.supported_api_versions_to_string()); - - println!("\n\n"); - } - - println!("HarmonyLink ©️ Jordon Brooks 2023"); - - - let sys = actix_web::rt::System::new(); - sys.block_on(async { - let result = api::server::start_actix_web(PORT).expect("err"); - - let _ = result.await; - }); -} diff --git a/src/v1/all_info/mod.rs b/src/v1/all_info/mod.rs deleted file mode 100644 index 8a30527..0000000 --- a/src/v1/all_info/mod.rs +++ /dev/null @@ -1,2 +0,0 @@ -pub mod stats; -pub mod structs; \ No newline at end of file diff --git a/src/v1/all_info/stats.rs b/src/v1/all_info/stats.rs deleted file mode 100644 index 1e3ebc6..0000000 --- a/src/v1/all_info/stats.rs +++ /dev/null @@ -1,18 +0,0 @@ -use crate::v1::docking; -use crate::v1::battery; -use crate::v1::os; -use crate::version; - -use super::structs::Allinfo; - -/* This will query all the modules and return all the combined data */ -pub fn get_all_info() -> Result> { - let mut all_info = Allinfo::new(); - - all_info.dock = docking::stats::get_dock_info()?; - all_info.battery = battery::stats::get_battery_info()?; - all_info.os = os::stats::get_os()?; - all_info.version = version::info::Version::get(); - - Ok(all_info) -} \ No newline at end of file diff --git a/src/v1/all_info/structs.rs b/src/v1/all_info/structs.rs deleted file mode 100644 index 6e39a11..0000000 --- a/src/v1/all_info/structs.rs +++ /dev/null @@ -1,24 +0,0 @@ -use serde::{Deserialize, Serialize}; -use crate::{v1::{os, battery, docking::{self, structs::DockInfo}}, version}; - - -#[derive(Deserialize, Serialize, Clone)] -pub struct Allinfo { - pub os: os::structs::OSInfo, - pub battery: battery::structs::BatteryInfo, - pub dock: docking::structs::DockInfo, - pub version: version::info::Version -} - -impl Allinfo { - pub fn new() -> Allinfo { - Allinfo { os: os::structs::OSInfo::new(), - battery: battery::structs::BatteryInfo::new(), - dock: DockInfo::new(), - version: version::info::Version::get() - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } -} \ No newline at end of file diff --git a/src/v1/battery/mod.rs b/src/v1/battery/mod.rs deleted file mode 100644 index 8a30527..0000000 --- a/src/v1/battery/mod.rs +++ /dev/null @@ -1,2 +0,0 @@ -pub mod stats; -pub mod structs; \ No newline at end of file diff --git a/src/v1/battery/stats.rs b/src/v1/battery/stats.rs deleted file mode 100644 index 0ffb957..0000000 --- a/src/v1/battery/stats.rs +++ /dev/null @@ -1,38 +0,0 @@ -use crate::v1::battery::structs::ChargingStatus; - -use super::structs::BatteryInfo; - -pub fn get_battery_info() -> Result> { - let mut battery_info = BatteryInfo { has_battery: false, battery_percent: 0, charging_status: ChargingStatus::UNKNOWN }; - - let manager = battery::Manager::new().unwrap(); - - battery_info.has_battery = manager.batteries().unwrap().count() > 0; - - if !battery_info.has_battery { - return Ok(battery_info); - } - - for (idx, battery) in manager.batteries()?.enumerate() { - let battery = battery?; - let state = battery.state(); - let energy = battery.energy(); - let full_energy = battery.energy_full(); - let state_of_charge = (energy / full_energy).get::(); - - println!("Battery #{}:", idx); - println!("Charging status: {:?}", state); - println!("Charge level: {:.2}%", state_of_charge); - - battery_info.battery_percent = state_of_charge.round() as i8; - battery_info.charging_status = match state { - battery::State::Charging => ChargingStatus::Charging, - battery::State::Discharging => ChargingStatus::Battery, - battery::State::Empty => ChargingStatus::Battery, - battery::State::Full => ChargingStatus::Battery, - _ => ChargingStatus::UNKNOWN, - } - } - - Ok(battery_info) -} \ No newline at end of file diff --git a/src/v1/battery/structs.rs b/src/v1/battery/structs.rs deleted file mode 100644 index 2f9f202..0000000 --- a/src/v1/battery/structs.rs +++ /dev/null @@ -1,28 +0,0 @@ -use serde::{Deserialize, Serialize}; - -#[derive(Deserialize, Serialize, PartialEq, Clone)] -pub enum ChargingStatus { - Charging, - Battery, - UNKNOWN, -} - -#[derive(Deserialize, Serialize, Clone)] -pub struct BatteryInfo { - pub has_battery: bool, - pub battery_percent: i8, - pub charging_status: ChargingStatus, -} - -impl BatteryInfo { - pub fn new() -> BatteryInfo { - BatteryInfo { - has_battery: false, - battery_percent: 0, - charging_status: ChargingStatus::UNKNOWN - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } -} \ No newline at end of file diff --git a/src/v1/docking/mod.rs b/src/v1/docking/mod.rs deleted file mode 100644 index 8a30527..0000000 --- a/src/v1/docking/mod.rs +++ /dev/null @@ -1,2 +0,0 @@ -pub mod stats; -pub mod structs; \ No newline at end of file diff --git a/src/v1/docking/stats.rs b/src/v1/docking/stats.rs deleted file mode 100644 index f24fc90..0000000 --- a/src/v1/docking/stats.rs +++ /dev/null @@ -1,90 +0,0 @@ -use std::{io::BufReader, fs::File}; - -#[allow(unused_imports)] -use std::collections::HashSet; - -use crate::{v1::{battery::{stats::get_battery_info, structs::ChargingStatus}}, USE_FALLBACK_DOCK_DETECTION}; - -use super::structs::{Dock, DockInfo}; - -/* This will get the current dock info. */ -pub fn get_dock_info() -> Result> { - let mut dock = DockInfo::new(); - dock.dock_info = get_dock()?; - - dock.is_docked = dock.dock_info.brand == String::new() && dock.dock_info.model == String::new(); - - /* - This code will manually detect a dock if it wasn't automatically picked up by get_dock(). - The code currently doesnt work. To manually detect a dock we will detect the presence of - a battery, charging of the handheld, and eventually when I find a cross-platform create, - it will also detect the presence of an external monitor (will most likely only work on a - Steam Deck for now) - */ - if USE_FALLBACK_DOCK_DETECTION { - if !dock.is_docked { - dock.fallback_detection = true; - - let battery_info = get_battery_info()?; - - if battery_info.has_battery && battery_info.charging_status == ChargingStatus::Charging { - } - } - } - - Ok(dock) -} - -/* Reads the dock_models.json file and returns a vector of structs with the data */ -#[allow(dead_code)] -pub fn read_dock_models_from_file() -> Result, Box> { - let file = File::open("Resources/dock_models.json")?; - let reader = BufReader::new(file); - let dock_models: Vec = serde_json::from_reader(reader)?; - Ok(dock_models) -} - -#[cfg(target_os = "linux")] -/* This will detect the dock model and brand. */ -pub fn get_dock() -> Result> { - let devices = rusb::devices()?; - let dock_models = read_dock_models_from_file()?; - - for dock_model in dock_models { - let mut found_components = HashSet::new(); - - for device in devices.iter() { - let device_desc = device.device_descriptor()?; - let device_id = (device_desc.vendor_id(), device_desc.product_id()); - - // Check if the device is one of the components of the dock. - if dock_model.usb_ids.contains(&[device_desc.vendor_id(), device_desc.product_id()]) { - found_components.insert(device_id); - println!("(get_dock) Detected: {}", serde_json::to_string_pretty(&device_id)?); - } - } - - if found_components.len() == dock_model.usb_ids.len() { - println!("(get_dock) All components detected for {}", serde_json::to_string_pretty(&dock_model)?); - return Ok(Dock { - model: dock_model.model.clone(), - brand: dock_model.brand.clone(), - usb_ids: dock_model.usb_ids.clone() - }); - } - } - Ok(Dock::new()) -} - -#[cfg(target_os = "macos")] -/* This will detect the dock model and brand. */ -pub fn get_dock() -> Result> { - Ok(Dock::new()) - //Err(Box::new(std::io::Error::new(std::io::ErrorKind::Other, "Incorrect OS"))) -} - -/* This will detect the dock model and brand. */ -#[cfg(target_os = "windows")] -pub fn get_dock() -> Result> { - Ok(Dock::new()) -} \ No newline at end of file diff --git a/src/v1/docking/structs.rs b/src/v1/docking/structs.rs deleted file mode 100644 index 4a165f2..0000000 --- a/src/v1/docking/structs.rs +++ /dev/null @@ -1,39 +0,0 @@ -use serde::{Deserialize, Serialize}; - -#[derive(Deserialize, Serialize, Clone)] -pub struct Dock { - pub brand: String, // ex: JSAUX - pub model: String, // ex: HB0603 - pub usb_ids: Vec<[u16; 2]>, -} - -impl Dock { - pub fn new() -> Dock { - Dock { brand: String::new(), - model: String::new(), - usb_ids: vec![], - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } -} - -#[derive(Deserialize, Serialize, Clone)] -pub struct DockInfo { - pub dock_info: Dock, - pub is_docked: bool, - pub fallback_detection: bool, -} - -impl DockInfo { - pub fn new() -> DockInfo { - DockInfo { dock_info: Dock::new(), - is_docked: false, - fallback_detection: false - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } -} \ No newline at end of file diff --git a/src/v1/mod.rs b/src/v1/mod.rs deleted file mode 100644 index 1f4beb0..0000000 --- a/src/v1/mod.rs +++ /dev/null @@ -1,4 +0,0 @@ -pub mod battery; -pub mod docking; -pub mod os; -pub mod all_info; \ No newline at end of file diff --git a/src/v1/os/mod.rs b/src/v1/os/mod.rs deleted file mode 100644 index 8a30527..0000000 --- a/src/v1/os/mod.rs +++ /dev/null @@ -1,2 +0,0 @@ -pub mod stats; -pub mod structs; \ No newline at end of file diff --git a/src/v1/os/stats.rs b/src/v1/os/stats.rs deleted file mode 100644 index 200da63..0000000 --- a/src/v1/os/stats.rs +++ /dev/null @@ -1,45 +0,0 @@ -use super::structs::{OSInfo, Platform, Architecture}; - -pub fn get_platform() -> Platform { - if cfg!(target_os = "windows") { - Platform::WINDOWS - } else if cfg!(target_os = "macos") { - Platform::MAC - } else if cfg!(target_os = "linux") { - Platform::LINUX - } else { - Platform::UNKNOWN - } -} - - -pub fn get_os() -> Result> { - let mut temp = OSInfo::new(); - let info = os_info::get(); - - temp.platform = get_platform(); - - temp.name = match info.codename() { - Some(s) => s.to_string(), - _ => String::new(), - }; - - temp.version = info.version().to_string(); - - if temp.name == String::new() { - temp.name = match info.edition() { - Some(s) => s.to_string(), - _ => String::new(), - }; - } - - temp.bits = match info.bitness() - { - os_info::Bitness::X32 => Architecture::X86, - os_info::Bitness::X64 => Architecture::X86_64, - _ => Architecture::UNKNOWN, - }; - - Ok(temp) - -} \ No newline at end of file diff --git a/src/v1/os/structs.rs b/src/v1/os/structs.rs deleted file mode 100644 index 48db188..0000000 --- a/src/v1/os/structs.rs +++ /dev/null @@ -1,38 +0,0 @@ -use serde::{Deserialize, Serialize}; - -#[derive(Deserialize, Serialize, PartialEq, Clone)] -pub enum Platform { - WINDOWS = 0, - LINUX = 1, - MAC = 2, - UNKNOWN = 255 -} - -#[derive(Deserialize, Serialize, Clone)] -pub enum Architecture { - X86 = 0, - X86_64 = 1, - UNKNOWN = 255, -} - -#[derive(Deserialize, Serialize, Clone)] -pub struct OSInfo { - pub platform: Platform, // Windows, Mac, Linux - pub name: String, // "Windows 11 2306", "Ubuntu 22.04 LTS" - pub version: String, // 2306, 22.04 - pub bits: Architecture // 32, 64 -} - -impl OSInfo { - pub fn new() -> OSInfo { - OSInfo { - platform: Platform::UNKNOWN, - name: String::new(), - version: String::new(), - bits: Architecture::UNKNOWN - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } -} \ No newline at end of file diff --git a/src/version/info.rs b/src/version/info.rs deleted file mode 100644 index 52bcba7..0000000 --- a/src/version/info.rs +++ /dev/null @@ -1,41 +0,0 @@ -use serde::{Deserialize, Serialize}; - -#[derive(Deserialize, Serialize, Clone)] -pub struct Version { - pub build_timestamp: String, - pub git_branch: String, - pub git_describe: String, - pub git_commit_timestamp: String, - pub debug: bool, - pub version: String, - pub version_major: i32, - pub version_minor: i32, - pub version_patch: i32, - pub version_pre: String, - pub supported_api_versions: Vec -} - -impl Version { - pub fn get() -> Version { - Version { - build_timestamp: env!("VERGEN_BUILD_TIMESTAMP").to_string(), - git_branch: env!("VERGEN_GIT_BRANCH").to_string(), - git_describe: env!("VERGEN_GIT_DESCRIBE").to_string(), - git_commit_timestamp: env!("VERGEN_GIT_COMMIT_TIMESTAMP").to_string(), - debug: env!("VERGEN_CARGO_DEBUG").parse().unwrap(), - version: env!("CARGO_PKG_VERSION").to_string(), - version_major: env!("CARGO_PKG_VERSION_MAJOR").parse().unwrap(), - version_minor: env!("CARGO_PKG_VERSION_MINOR").parse().unwrap(), - version_patch: env!("CARGO_PKG_VERSION_PATCH").parse().unwrap(), - version_pre: "Alpha".to_string(), - supported_api_versions: vec!["v1".to_string()] - } - } - pub fn to_string(self) -> String { - serde_json::to_string(&self).expect("Failed to parse into string") - } - pub fn supported_api_versions_to_string(self) -> String { - self.supported_api_versions.join(", ") - } - -} \ No newline at end of file diff --git a/src/version/mod.rs b/src/version/mod.rs deleted file mode 100644 index 55cc091..0000000 --- a/src/version/mod.rs +++ /dev/null @@ -1 +0,0 @@ -pub mod info; \ No newline at end of file From bc436af66ebf67dacfaac2fb70f8dbb2b6f97bde Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Jan 2024 21:56:00 +0000 Subject: [PATCH 06/54] Updated README.md for the new upcoming changes of HarmonyLink 2.0 --- README.md | 151 +++++++++++++++++++++++++----------------------------- 1 file changed, 70 insertions(+), 81 deletions(-) diff --git a/README.md b/README.md index e2e66a0..5857938 100644 --- a/README.md +++ b/README.md @@ -2,119 +2,108 @@ HarmonyLinkLogo

-

- - Download HarmonyLink - -

- -Welcome to the server-side application for the HarmonyLink project. This innovative software is developed with the Rust programming language and is aimed at enhancing the handheld gaming experience. +Welcome to HarmonyLink 2.0. This iteration represents a leap forward in enhancing the handheld gaming experience, now re-engineered as a C++ dynamic link library (DLL) for seamless integration directly into games. ## Table of Contents -- [Shaping the Vision, Living the Reality](#shaping-the-vision,-living-the-reality) - [Key Features](#key-features) -- [Using the Program](#using-the-program) - - [Windows Users](#windows-users) - - [Steam Deck (Linux) Users](#steam-deck-linux-users) +- [HarmonyLink in Action](#harmonylink-in-action) +- [Integration Guide](#integration-guide) + - [For Game Developers](#for-game-developers) + - [Unreal Engine 5 Plugin](#unreal-engine-5-plugin) +- [Building From Source](#building-from-source) - [How It Works](#how-it-works) -- [Getting Started](https://github.com/Jordonbc/HarmonyLinkServer/wiki/Getting-Started) -- [HarmonyLink: View](#harmonylink-view) -- [Showcasing HarmonyLink](#showcasing-harmonylink) +- [Getting Started](https://github.com/Jordonbc/HarmonyLink/wiki/Getting-Started) - [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq) +- [Contributing](#contributing) - [License](#license) -## Shaping the Vision, Living the Reality - -HarmonyLink is on a mission to transform handheld gaming by providing an interactive experience. This server-side application is at the heart of making this vision a reality. - ## Key Features -1. **Device Identification**: HarmonyLink equips games with the ability to identify the specific handheld device they are operating on. -2. **Real-Time Metrics**: Games can access real-time data about the handheld device's power usage and docking status through HarmonyLink. -3. **Cross-Platform Compatibility**: HarmonyLink extends its functionality to Windows games running on Proton/Wine. +- **Intelligent Hardware Recognition**: HarmonyLink 2.0 can accurately identify specific devices like the Steam Deck without relying on manual environment variables or command line arguments. + +- **Robust API**: The API provided by HarmonyLink 2.0 offers developers straightforward and effortless access to detailed system information. Designed with intuitiveness in mind, it allows for rapid integration into projects, minimizing development overhead. -## Using HarmonyLinkServer +- **Enhanced Adaptability**: With the ability to dynamically adjust game settings and performance based on detected hardware capabilities and current operating conditions, HarmonyLink 2.0 ensures games are optimized for each specific device. -For users who wish to run the precompiled release version of HarmonyLinkServer, please follow the instructions specific to your platform below. +- **Wine Environment Detection**: HarmonyLink 2.0 includes mechanisms to detect when it is running within a Wine environment, enabling it to deliver system information about the underlying Linux system while operating through Wine. -### Windows Users +- **Precise Steam Deck Hardware Detection**: Unlike conventional methods that may rely on environment variables, HarmonyLink 2.0 detects the presence of Steam Deck hardware directly, ensuring reliable identification and optimization for this specific device. -1. Navigate to the [latest release](https://github.com/Jordonbc/HarmonyLinkServer/releases/latest) on the project's GitHub page. -2. Download the `.zip` archive for Windows. -3. Extract the contents of the `.zip` archive to a directory of your choice. -4. Open a command prompt in the directory where you extracted the files. -5. Run the HarmonyLinkServer executable by typing `./harmony_link_server.exe`. +- **Battery and Charging Status Awareness**: The software provides real-time data on battery levels and charging status, allowing games to adapt their behavior based on power availability and to manage resource usage effectively. -Please note that you'll need to manually start the program each time you want to use it. +- **Cross-Platform Functionality**: HarmonyLink 2.0 is designed to work on Windows (including Wine environments) as well as natively on Linux, offering broad support for a variety of gaming setups. -### Steam Deck (Linux) Users +- **Unreal Engine 5 Compatibility**: HarmonyLink 2.0 comes with full support for Unreal Engine 5, making it a versatile tool for developers working with one of the most advanced game engines in the industry. -1. Navigate to the [latest release](https://github.com/Jordonbc/HarmonyLinkServer/releases/latest) on the project's GitHub page. -2. Download the `.zip` archive for Linux. -3. Extract the contents of the `.zip` archive to a directory of your choice. +## HarmonyLink in Action -#### Running in Desktop Mode - -To use HarmonyLinkServer in Desktop Mode, follow these steps: - -1. Open a terminal in the directory where you extracted the files. -2. Run the HarmonyLinkServer executable by typing `./harmony_link_server`. - -Please note that you'll need to keep the terminal window open while using HarmonyLinkServer in desktop mode. - -#### Optional: Setting Up as a Service for Gamemode - -For a seamless experience in gamemode, you have the option to set up HarmonyLinkServer as a service on your Steam Deck. Please be aware that this setup process will require a moderate level of technical knowledge. - -## How It Works - -HarmonyLink operates using a client-server structure. This server-side application runs on the host side (native Linux or Windows), and games access the metrics via an API. - -Developers and modders can easily implement GET and POST requests from the API, integrating system metrics into games. These metrics can be used to adapt the game's quality settings, providing a more customized gaming experience. - -## HarmonyLink: View - -To view the API in action, check out [HarmonyLink: View](https://github.com/Jordonbc/HarmonyLinkView). This sister project provides a comprehensive interface to see what data the API is providing. - -## Showcasing HarmonyLink - -👇 To help visualize its functionality, we've included a demonstration video that showcases HarmonyLink in action on a Steam Deck in gamemode. +Experience the capabilities of HarmonyLink: Legacy (June 2023 version) with our demonstration: [![HarmonyLink in action](https://img.youtube.com/vi/qU3w_fo4nY4/0.jpg)](https://www.youtube.com/watch?v=qU3w_fo4nY4) -## Contributing Guidelines +## Integration Guide -Please refer to our [Contributing Guidelines](CONTRIBUTING.md) for detailed information on how to contribute to HarmonyLinkServer. It includes instructions for bug reports, feature requests, and pull requests. +### For Game Developers -We appreciate your interest in improving HarmonyLinkServer and look forward to your contributions! +Integrate HarmonyLink 2.0 into your game project with ease: + +1. Download the latest version of HarmonyLink 2.0 from the [releases page](https://github.com/Jordonbc/HarmonyLink/releases/latest). +2. Add the HarmonyLink DLL to your project according to your development environment's specifications. +3. Utilize the provided API to access device-specific metrics and enhance your game's performance on handheld devices. + +Refer to the [integration documentation](https://github.com/Jordonbc/HarmonyLink/wiki/Integration-Guide) for detailed instructions. + +### Unreal Engine 5 Plugin + +For developers leveraging Unreal Engine 5.3 or newer*, HarmonyLink 2.0 is readily accessible as a plugin: + +1. Clone or download the HarmonyLink UE5 Plugin from the [Unreal Engine Plugin repository](https://github.com/Jordonbc/HarmonyLinkUE5Plugin). +2. Place the HarmonyLink plugin folder into the `Plugins` directory of your Unreal Engine 5 project. +3. Enable the HarmonyLink plugin from the Edit > Plugins menu within Unreal Engine 5. +4. Access HarmonyLink functionalities via Blueprints or C++ within your project. + +For a step-by-step guide, visit the [Unreal Engine 5 Plugin instructions](https://github.com/Jordonbc/HarmonyLinkUE5Plugin/wiki/Integration-Guide) on our wiki. + +*With potential backward compatibility, not verified. + +## Building From Source + +If you prefer to build HarmonyLink 2.0 from the source code, follow these steps: + +1. Clone the repository using `git clone https://github.com/Jordonbc/HarmonyLink.git`. +2. Navigate into the cloned directory with `cd HarmonyLink`. +3. Ensure CMake is installed and up-to-date on your system. +4. Generate the build configuration with `cmake -S . -B build`. +5. Compile the code by running `cmake --build build --config Release`. +6. The built DLL will be located in the `build/bin/HarmonyLinkLib` directory. + +For additional building options and troubleshooting, refer to the [building from source documentation](https://github.com/Jordonbc/HarmonyLink/wiki/Building-From-Source). + + +## How It Works + +HarmonyLink 2.0 functions without the need for a separate server application. The DLL is integrated directly into the game, providing a conduit between the game and the device hardware for real-time metrics and enhanced performance adaptability. ## Frequently Asked Questions (FAQ) -### What platforms are supported by HarmonyLink? +- **What new capabilities does HarmonyLink 2.0 bring?** + HarmonyLink 2.0 offers a streamlined, more efficient way for games to interact with handheld hardware, now as a C++ DLL for easy integration without the need for server-side components. -A: HarmonyLink supports both native Linux and Windows platforms, and extends its functionality to Windows games running on Proton/Wine. +- **How can developers integrate HarmonyLink 2.0 into their games?** + Developers can include HarmonyLink 2.0 in their projects by adding the DLL and making API calls as needed. Detailed instructions are available on our wiki. -### Why does HarmonyLink require an external program in addition to a game engine plugin? +- **Does HarmonyLink 2.0 support Proton/Wine?** + Yes, it includes workarounds and functionalities tailored for games running in Proton/Wine environments. -A: HarmonyLink utilizes an external program alongside the game engine plugin to ensure accurate data is passed to the game and to probe low-level hardware for more precise dock information. By having a separate server-side application, HarmonyLink can establish a standardized API that allows games to access real-time metrics and adapt their settings accordingly. Additionally, the use of an external program helps address potential compatibility issues with Proton/Wine layers and ensures seamless integration with different game engines. +- **Does HarmonyLink 2.0 rely `STEAM_DECK=1`?** -### How can I get started with HarmonyLink? +No, HarmonyLink 2.0 does not rely on the `STEAM_DECK=1` environment variable. Instead, it employs advanced hardware detection techniques to accurately identify the presence of specific devices, such as the Steam Deck. This direct detection method ensures reliable performance optimization tailored to the actual hardware, independent of any user-modified environment settings. -A: You can start by cloning the HarmonyLinkServer repository. Detailed instructions are provided on the [Getting Started](https://github.com/Jordonbc/HarmonyLinkServer/wiki/Getting-Started) wiki page. +## Contributing -### Can HarmonyLink be used with games developed in different game engines? - -A: Yes, HarmonyLink is designed to be engine-agnostic and can be used with games developed in different engines. For Unreal Engine, there is a specific [Unreal Engine Plugin](https://github.com/Jordonbc/HarmonyLinkUE) available. - -### Is HarmonyLink only for game developers, or can players also use it? - -A: While game developers will find HarmonyLink particularly useful for optimizing their games for handheld devices, players can also benefit from the enhanced gaming experience that HarmonyLink provides. - -### Does HarmonyLink have any impact on the performance of the games? - -A: HarmonyLink is designed to be lightweight and efficient, with minimal impact on game performance. The primary purpose of HarmonyLink is to enhance game performance by allowing games to adapt their settings based on real-time device metrics. +Your contributions make HarmonyLink better. Please review our [Contributing Guidelines](CONTRIBUTING.md) for information on submitting pull requests and helping with development. ## License -This project is licensed under the GNU General Public License v3.0 or later. Please do not redistribute HarmonyLinkServer. e.g.: Proving an alternative download link or distributing with a game. +HarmonyLink 2.0 is released under the GNU General Public License v3.0 or later. See the [LICENSE](LICENSE) file for details. From 9bd9ea2623ec3bcf94783eabbb20034fc05f104f Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Jan 2024 22:41:47 +0000 Subject: [PATCH 07/54] Removed tests folder & only detect license in root folder --- .gitignore | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/.gitignore b/.gitignore index d567bc0..e8a23a4 100644 --- a/.gitignore +++ b/.gitignore @@ -10,9 +10,8 @@ build/** !.gitmodules !CMakeLists.txt -!license +!/license !readme.md !HarmonyLinkLib/** -!HarmonyLinkTest/** -!tests/** \ No newline at end of file +!HarmonyLinkTest/** \ No newline at end of file From 67169fb602292019df2fb8d7ffc29162b8272ea5 Mon Sep 17 00:00:00 2001 From: Jordon Brooks <16258926+Jordonbc@users.noreply.github.com> Date: Sun, 7 Jan 2024 22:49:46 +0000 Subject: [PATCH 08/54] Update issue templates --- .github/ISSUE_TEMPLATE/bug_report.md | 38 +++++++++++++++++++++++ .github/ISSUE_TEMPLATE/feature_request.md | 20 ++++++++++++ 2 files changed, 58 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..dd84ea7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,38 @@ +--- +name: Bug report +about: Create a report to help us improve +title: '' +labels: '' +assignees: '' + +--- + +**Describe the bug** +A clear and concise description of what the bug is. + +**To Reproduce** +Steps to reproduce the behavior: +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +**Expected behavior** +A clear and concise description of what you expected to happen. + +**Screenshots** +If applicable, add screenshots to help explain your problem. + +**Desktop (please complete the following information):** + - OS: [e.g. iOS] + - Browser [e.g. chrome, safari] + - Version [e.g. 22] + +**Smartphone (please complete the following information):** + - Device: [e.g. iPhone6] + - OS: [e.g. iOS8.1] + - Browser [e.g. stock browser, safari] + - Version [e.g. 22] + +**Additional context** +Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..bbcbbe7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: '' +labels: '' +assignees: '' + +--- + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + +**Describe alternatives you've considered** +A clear and concise description of any alternative solutions or features you've considered. + +**Additional context** +Add any other context or screenshots about the feature request here. From d4a24204f9287cdd5cfc3965b21599a4ff980245 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Jan 2024 22:54:12 +0000 Subject: [PATCH 09/54] Add whitelist for .github folder --- .github/workflows/cmake-multi-platform.yml | 91 ++++++++++++++++++++++ .gitignore | 1 + 2 files changed, 92 insertions(+) create mode 100644 .github/workflows/cmake-multi-platform.yml diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml new file mode 100644 index 0000000..dd86440 --- /dev/null +++ b/.github/workflows/cmake-multi-platform.yml @@ -0,0 +1,91 @@ +# This starter workflow is for a CMake project running on multiple platforms. There is a different starter workflow if you just want a single platform. +# See: https://github.com/actions/starter-workflows/blob/main/ci/cmake-single-platform.yml +name: CMake on multiple platforms + +on: + workflow_dispatch: + push: + branches: [ "Stable" ] + pull_request: + branches: [ "Stable" ] + +jobs: + build: + runs-on: ${{ matrix.os }} + + strategy: + # Set fail-fast to false to ensure that feedback is delivered for all matrix combinations. Consider changing this to true when your workflow is stable. + fail-fast: false + + # Set up a matrix to run the following 3 configurations: + # 1. + # 2. + # 3. + # + # To add more build types (Release, Debug, RelWithDebInfo, etc.) customize the build_type list. + matrix: + os: [ubuntu-latest, windows-latest, macos-latest] + build_type: [Release] + c_compiler: [gcc, clang, cl] + cpp_compiler: [g++, clang++, cl] + include: + - os: windows-latest + c_compiler: cl + cpp_compiler: cl + - os: ubuntu-latest + c_compiler: gcc + cpp_compiler: g++ + - os: ubuntu-latest + c_compiler: clang + cpp_compiler: clang++ + - os: macos-latest + c_compiler: clang + cpp_compiler: clang++ + exclude: + - os: windows-latest + c_compiler: gcc + - os: windows-latest + c_compiler: clang + - os: ubuntu-latest + c_compiler: cl + - os: ubuntu-latest + cpp_compiler: cl + - os: macos-latest + c_compiler: gcc + - os: macos-latest + cpp_compiler: g++ + - os: macos-latest + c_compiler: cl + - os: macos-latest + cpp_compiler: cl + steps: + - uses: actions/checkout@v3 + with: + submodules: 'recursive' + + - name: Set reusable strings + # Turn repeated input strings (such as the build output directory) into step outputs. These step outputs can be used throughout the workflow file. + id: strings + shell: bash + run: | + echo "build-output-dir=${{ github.workspace }}/build" >> "$GITHUB_OUTPUT" + + - name: Configure CMake + # Configure CMake in a 'build' subdirectory. `CMAKE_BUILD_TYPE` is only required if you are using a single-configuration generator such as make. + # See https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html?highlight=cmake_build_type + run: > + cmake -B ${{ steps.strings.outputs.build-output-dir }} + -DCMAKE_CXX_COMPILER=${{ matrix.cpp_compiler }} + -DCMAKE_C_COMPILER=${{ matrix.c_compiler }} + -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} + -S ${{ github.workspace }} + + - name: Build + # Build your program with the given configuration. Note that --config is needed because the default Windows generator is a multi-config generator (Visual Studio generator). + run: cmake --build ${{ steps.strings.outputs.build-output-dir }} --config ${{ matrix.build_type }} + + - name: Test + working-directory: ${{ steps.strings.outputs.build-output-dir }} + # Execute tests defined by the CMake configuration. Note that --build-config is needed because the default Windows generator is a multi-config generator (Visual Studio generator). + # See https://cmake.org/cmake/help/latest/manual/ctest.1.html for more detail + run: ctest --build-config ${{ matrix.build_type }} diff --git a/.gitignore b/.gitignore index e8a23a4..e716f44 100644 --- a/.gitignore +++ b/.gitignore @@ -13,5 +13,6 @@ build/** !/license !readme.md +!.github/** !HarmonyLinkLib/** !HarmonyLinkTest/** \ No newline at end of file From d36a9a6f5ff4ad80b0cc0122da764a90818dd989 Mon Sep 17 00:00:00 2001 From: Jordon Brooks <16258926+Jordonbc@users.noreply.github.com> Date: Sun, 7 Jan 2024 23:41:06 +0000 Subject: [PATCH 10/54] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5857938..c54b131 100644 --- a/README.md +++ b/README.md @@ -58,12 +58,12 @@ Refer to the [integration documentation](https://github.com/Jordonbc/HarmonyLink For developers leveraging Unreal Engine 5.3 or newer*, HarmonyLink 2.0 is readily accessible as a plugin: -1. Clone or download the HarmonyLink UE5 Plugin from the [Unreal Engine Plugin repository](https://github.com/Jordonbc/HarmonyLinkUE5Plugin). +1. Clone or download the HarmonyLink UE5 Plugin from the [Unreal Engine Plugin repository](https://github.com/Jordonbc/HarmonyLinkUE). 2. Place the HarmonyLink plugin folder into the `Plugins` directory of your Unreal Engine 5 project. 3. Enable the HarmonyLink plugin from the Edit > Plugins menu within Unreal Engine 5. 4. Access HarmonyLink functionalities via Blueprints or C++ within your project. -For a step-by-step guide, visit the [Unreal Engine 5 Plugin instructions](https://github.com/Jordonbc/HarmonyLinkUE5Plugin/wiki/Integration-Guide) on our wiki. +For a step-by-step guide, visit the [Unreal Engine 5 Plugin instructions](https://github.com/Jordonbc/HarmonyLinkUE/wiki/Integration-Guide) on our wiki. *With potential backward compatibility, not verified. From 98dd4c72f23098bff493f485071708dab530edd7 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Mon, 8 Jan 2024 02:31:35 +0000 Subject: [PATCH 11/54] Add image and align video --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5857938..30c9d6e 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,16 @@ Welcome to HarmonyLink 2.0. This iteration represents a leap forward in enhancin Experience the capabilities of HarmonyLink: Legacy (June 2023 version) with our demonstration: -[![HarmonyLink in action](https://img.youtube.com/vi/qU3w_fo4nY4/0.jpg)](https://www.youtube.com/watch?v=qU3w_fo4nY4) +

Video below ⬇️

+ +

+ HarmonyLinkExample +

+ +

+


+ HarmonyLinkExample +

## Integration Guide From a45777bb0a7eb99627b0943ed561ef9e1e2411e8 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Mon, 8 Jan 2024 02:33:58 +0000 Subject: [PATCH 12/54] Add whitelist for SteamDeckExample.jpg --- .gitignore | 1 + Images/SteamDeckExample.jpg | Bin 0 -> 512821 bytes 2 files changed, 1 insertion(+) create mode 100644 Images/SteamDeckExample.jpg diff --git a/.gitignore b/.gitignore index e716f44..46fd768 100644 --- a/.gitignore +++ b/.gitignore @@ -13,6 +13,7 @@ build/** !/license !readme.md +!Images/* !.github/** !HarmonyLinkLib/** !HarmonyLinkTest/** \ No newline at end of file diff --git a/Images/SteamDeckExample.jpg b/Images/SteamDeckExample.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9dc6fd54ea8912964253be0167b6b68aa0858b27 GIT binary patch literal 512821 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 z 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 vgUJA@_PUFSI};P9Vlg8 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℞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
    DDoY&+XqE7O_mi<9VfdDr;Ze+_T- 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

    GQNa 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 literal 0 HcmV?d00001 From f6e66ea08ca4cc449fd6b9e16331229a5069399d Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Mon, 8 Jan 2024 02:39:10 +0000 Subject: [PATCH 13/54] Added a sentence to the readme --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 30c9d6e..c5c5d9f 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,8 @@ Experience the capabilities of HarmonyLink: Legacy (June 2023 version) with our HarmonyLinkExample

    +The picture above shows a packaged Shipping build of a UE5 project with the HarmonyLink plugin enabled. Widgets we're added to the viewport to display these values. The values are updated on tick, with no noticable performance loss. + ## Integration Guide ### For Game Developers From 798a3181c8f29ec05b8805f38b68a1db268a31e3 Mon Sep 17 00:00:00 2001 From: Jordon Brooks <16258926+Jordonbc@users.noreply.github.com> Date: Mon, 8 Jan 2024 02:44:54 +0000 Subject: [PATCH 14/54] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0740e86..81a55f2 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,9 @@ Experience the capabilities of HarmonyLink: Legacy (June 2023 version) with our HarmonyLinkExample

    -The picture above shows a packaged Shipping build of a UE5 project with the HarmonyLink plugin enabled. Widgets we're added to the viewport to display these values. The values are updated on tick, with no noticable performance loss. +The picture above shows a packaged Win64 (exe) Shipping build of a UE5 project with the HarmonyLink plugin enabled running via Proton. Widgets were added to the viewport to display these values. The values are updated on tick, with no noticable performance loss. + +As you can see, Even though it's running on Proton, we can still detect the underlying system specifications. ## Integration Guide From d29965fca1612ec4caa2ee9c0728f00420bc2cb7 Mon Sep 17 00:00:00 2001 From: Jordon Brooks <16258926+Jordonbc@users.noreply.github.com> Date: Mon, 8 Jan 2024 03:28:51 +0000 Subject: [PATCH 15/54] Update LICENSE --- LICENSE | 875 +++++++++++++------------------------------------------- 1 file changed, 201 insertions(+), 674 deletions(-) diff --git a/LICENSE b/LICENSE index f288702..261eeb9 100644 --- a/LICENSE +++ b/LICENSE @@ -1,674 +1,201 @@ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - Preamble - - The GNU General Public License is a free, copyleft license for -software and other kinds of works. - - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. - - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. - - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. - - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. - - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. - - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. - - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. - - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. - - The precise terms and conditions for copying, distribution and -modification follow. - - TERMS AND CONDITIONS - - 0. Definitions. - - "This License" refers to version 3 of the GNU General Public License. - - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. - - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. - - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. - - A "covered work" means either the unmodified Program or a work based -on the Program. - - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. - - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. - - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. - - 1. Source Code. - - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. - - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. - - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. - - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. - - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. - - The Corresponding Source for a work in source code form is that -same work. - - 2. Basic Permissions. - - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. - - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. - - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. - - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. - - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. - - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. - - 4. Conveying Verbatim Copies. - - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. - - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. - - 5. Conveying Modified Source Versions. - - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: - - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. - - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". - - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. - - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. - - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. - - 6. Conveying Non-Source Forms. - - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: - - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. - - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. - - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. - - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. - - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. - - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. - - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. - - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. - - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). - - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. - - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. - - 7. Additional Terms. - - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. - - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. - - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: - - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or - - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or - - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or - - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or - - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or - - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. - - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. - - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. - - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. - - 8. Termination. - - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). - - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. - - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. - - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. - - 9. Acceptance Not Required for Having Copies. - - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. - - 10. Automatic Licensing of Downstream Recipients. - - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. - - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. - - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. - - 11. Patents. - - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". - - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. - - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. - - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. - - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. - - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. - - 12. No Surrender of Others' Freedom. - - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. - - 13. Use with the GNU Affero General Public License. - - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. - - 14. Revised Versions of this License. - - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. - - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. - - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. - - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. - - 15. Disclaimer of Warranty. - - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - - 16. Limitation of Liability. - - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. - - 17. Interpretation of Sections 15 and 16. - - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. - - END OF TERMS AND CONDITIONS - - How to Apply These Terms to Your New Programs - - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. - - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. - - - Copyright (C) - - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. - - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this program. If not, see . - -Also add information on how to contact you by electronic and paper mail. - - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: - - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. - -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". - - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. - - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. From 4702922b8e5060a9580da47543d11ebcc9408402 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Tue, 9 Jan 2024 20:48:43 +0000 Subject: [PATCH 16/54] Added Copyright notice to every file --- HarmonyLinkLib/include/Core.h | 14 +++++++++++++- HarmonyLinkLib/include/Enums/EDevice.h | 14 ++++++++++++++ HarmonyLinkLib/include/Enums/EPlatform.h | 14 ++++++++++++++ HarmonyLinkLib/include/FString.h | 14 +++++++++++++- HarmonyLinkLib/include/HarmonyLinkLib.h | 14 +++++++++++++- HarmonyLinkLib/include/HarmonyLinkStruct.h | 14 ++++++++++++++ HarmonyLinkLib/include/Structs/FBattery.h | 16 +++++++++++++++- HarmonyLinkLib/include/Structs/FCPUInfo.h | 14 ++++++++++++++ HarmonyLinkLib/include/Structs/FDevice.h | 14 ++++++++++++++ HarmonyLinkLib/include/Structs/FOSVerInfo.h | 16 +++++++++++++++- HarmonyLinkLib/include/Version.h | 15 ++++++++++++++- HarmonyLinkLib/include/Version.h.in | 14 ++++++++++++++ HarmonyLinkLib/src/HarmonyLinkLib.cpp | 16 +++++++++++++++- .../src/Platform/IPlatformUtilities.cpp | 16 +++++++++++++++- HarmonyLinkLib/src/Platform/IPlatformUtilities.h | 16 +++++++++++++++- .../src/Platform/Unix/Linux/LinuxUtilities.cpp | 16 +++++++++++++++- .../src/Platform/Unix/Linux/LinuxUtilities.h | 16 +++++++++++++++- .../src/Platform/Unix/Mac/MacUtilities.cpp | 16 +++++++++++++++- .../src/Platform/Unix/Mac/MacUtilities.h | 16 +++++++++++++++- .../src/Platform/Unix/UnixUtilities.cpp | 16 +++++++++++++++- HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h | 16 +++++++++++++++- .../src/Platform/Windows/WindowsUtilities.cpp | 16 +++++++++++++++- .../src/Platform/Windows/WindowsUtilities.h | 14 ++++++++++++++ HarmonyLinkLib/src/Platform/WineUtilities.cpp | 14 ++++++++++++++ HarmonyLinkLib/src/Platform/WineUtilities.h | 14 ++++++++++++++ HarmonyLinkLib/src/Version.cpp | 14 ++++++++++++++ HarmonyLinkLib/src/dllmain.cpp | 14 +++++++++++++- HarmonyLinkTest/src/main.cpp | 14 +++++++++++++- 28 files changed, 399 insertions(+), 18 deletions(-) diff --git a/HarmonyLinkLib/include/Core.h b/HarmonyLinkLib/include/Core.h index 90d63b4..ec6ef9d 100644 --- a/HarmonyLinkLib/include/Core.h +++ b/HarmonyLinkLib/include/Core.h @@ -1,4 +1,16 @@ -// Copyright (C) 2023 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. #pragma once diff --git a/HarmonyLinkLib/include/Enums/EDevice.h b/HarmonyLinkLib/include/Enums/EDevice.h index 75d3cc5..31f9bfe 100644 --- a/HarmonyLinkLib/include/Enums/EDevice.h +++ b/HarmonyLinkLib/include/Enums/EDevice.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include diff --git a/HarmonyLinkLib/include/Enums/EPlatform.h b/HarmonyLinkLib/include/Enums/EPlatform.h index c050ca3..66697ee 100644 --- a/HarmonyLinkLib/include/Enums/EPlatform.h +++ b/HarmonyLinkLib/include/Enums/EPlatform.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include diff --git a/HarmonyLinkLib/include/FString.h b/HarmonyLinkLib/include/FString.h index 3f23dc1..68ae766 100644 --- a/HarmonyLinkLib/include/FString.h +++ b/HarmonyLinkLib/include/FString.h @@ -1,4 +1,16 @@ -// Copyright (C) 2024 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. #pragma once diff --git a/HarmonyLinkLib/include/HarmonyLinkLib.h b/HarmonyLinkLib/include/HarmonyLinkLib.h index abd095e..aaa1887 100644 --- a/HarmonyLinkLib/include/HarmonyLinkLib.h +++ b/HarmonyLinkLib/include/HarmonyLinkLib.h @@ -1,4 +1,16 @@ -// Copyright (C) 2023 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. /** diff --git a/HarmonyLinkLib/include/HarmonyLinkStruct.h b/HarmonyLinkLib/include/HarmonyLinkStruct.h index aa4497d..362750b 100644 --- a/HarmonyLinkLib/include/HarmonyLinkStruct.h +++ b/HarmonyLinkLib/include/HarmonyLinkStruct.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once struct HarmonyLinkStruct diff --git a/HarmonyLinkLib/include/Structs/FBattery.h b/HarmonyLinkLib/include/Structs/FBattery.h index 6c41595..3a40095 100644 --- a/HarmonyLinkLib/include/Structs/FBattery.h +++ b/HarmonyLinkLib/include/Structs/FBattery.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include #include diff --git a/HarmonyLinkLib/include/Structs/FCPUInfo.h b/HarmonyLinkLib/include/Structs/FCPUInfo.h index 8694e6a..827bc40 100644 --- a/HarmonyLinkLib/include/Structs/FCPUInfo.h +++ b/HarmonyLinkLib/include/Structs/FCPUInfo.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include diff --git a/HarmonyLinkLib/include/Structs/FDevice.h b/HarmonyLinkLib/include/Structs/FDevice.h index 204a5da..50a1a5c 100644 --- a/HarmonyLinkLib/include/Structs/FDevice.h +++ b/HarmonyLinkLib/include/Structs/FDevice.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include diff --git a/HarmonyLinkLib/include/Structs/FOSVerInfo.h b/HarmonyLinkLib/include/Structs/FOSVerInfo.h index 6b62db3..a308a22 100644 --- a/HarmonyLinkLib/include/Structs/FOSVerInfo.h +++ b/HarmonyLinkLib/include/Structs/FOSVerInfo.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include "FString.h" #include "HarmonyLinkStruct.h" diff --git a/HarmonyLinkLib/include/Version.h b/HarmonyLinkLib/include/Version.h index 61d6e3f..dcc9d33 100644 --- a/HarmonyLinkLib/include/Version.h +++ b/HarmonyLinkLib/include/Version.h @@ -1,4 +1,17 @@ -// Copyright (C) 2024 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include "Core.h" diff --git a/HarmonyLinkLib/include/Version.h.in b/HarmonyLinkLib/include/Version.h.in index 4081f8d..08881c5 100644 --- a/HarmonyLinkLib/include/Version.h.in +++ b/HarmonyLinkLib/include/Version.h.in @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + // Version.h.in #pragma once diff --git a/HarmonyLinkLib/src/HarmonyLinkLib.cpp b/HarmonyLinkLib/src/HarmonyLinkLib.cpp index d3f0bc2..fecfc97 100644 --- a/HarmonyLinkLib/src/HarmonyLinkLib.cpp +++ b/HarmonyLinkLib/src/HarmonyLinkLib.cpp @@ -1,4 +1,18 @@ -#include "HarmonyLinkLib.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "HarmonyLinkLib.h" #include #include "Platform/IPlatformUtilities.h" diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 44d6e80..4475379 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -1,4 +1,18 @@ -#include "IPlatformUtilities.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "IPlatformUtilities.h" #include diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h index b3d55da..933b5db 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include "Structs/FBattery.h" #include "Structs/FCPUInfo.h" diff --git a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp index fa7e4ff..490e869 100644 --- a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.cpp @@ -1,4 +1,18 @@ -#include "LinuxUtilities.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "LinuxUtilities.h" #include diff --git a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h index 6e7d780..ee1f516 100644 --- a/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h +++ b/HarmonyLinkLib/src/Platform/Unix/Linux/LinuxUtilities.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include "Structs/FOSVerInfo.h" diff --git a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp index 2166845..001364c 100644 --- a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.cpp @@ -1,4 +1,18 @@ -#include "MacUtilities.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "MacUtilities.h" namespace HarmonyLinkLib { diff --git a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h index e636401..237a0c5 100644 --- a/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h +++ b/HarmonyLinkLib/src/Platform/Unix/Mac/MacUtilities.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include "Platform/Unix/UnixUtilities.h" diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp index 46ef352..98864a1 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp @@ -1,4 +1,18 @@ -#include "UnixUtilities.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "UnixUtilities.h" namespace HarmonyLinkLib { diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h index b17e42e..c627c0a 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h @@ -1,4 +1,18 @@ -#pragma once +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once #include "Platform/IPlatformUtilities.h" namespace HarmonyLinkLib diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp index 4384a7a..6185502 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp @@ -1,4 +1,18 @@ -#include "WindowsUtilities.h" +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "WindowsUtilities.h" #include #include diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h index 849d269..583ca45 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include "Platform/IPlatformUtilities.h" diff --git a/HarmonyLinkLib/src/Platform/WineUtilities.cpp b/HarmonyLinkLib/src/Platform/WineUtilities.cpp index 3b420b1..efe48a3 100644 --- a/HarmonyLinkLib/src/Platform/WineUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/WineUtilities.cpp @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #include "WineUtilities.h" #include diff --git a/HarmonyLinkLib/src/Platform/WineUtilities.h b/HarmonyLinkLib/src/Platform/WineUtilities.h index 33f2b30..5e5bdae 100644 --- a/HarmonyLinkLib/src/Platform/WineUtilities.h +++ b/HarmonyLinkLib/src/Platform/WineUtilities.h @@ -1,3 +1,17 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #pragma once #include "Structs/FBattery.h" diff --git a/HarmonyLinkLib/src/Version.cpp b/HarmonyLinkLib/src/Version.cpp index 50b5049..d340da1 100644 --- a/HarmonyLinkLib/src/Version.cpp +++ b/HarmonyLinkLib/src/Version.cpp @@ -1 +1,15 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + #include "Version.h" diff --git a/HarmonyLinkLib/src/dllmain.cpp b/HarmonyLinkLib/src/dllmain.cpp index a292db4..5e6df48 100644 --- a/HarmonyLinkLib/src/dllmain.cpp +++ b/HarmonyLinkLib/src/dllmain.cpp @@ -1,4 +1,16 @@ -// Copyright (C) 2024 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. #include #include "Version.h" diff --git a/HarmonyLinkTest/src/main.cpp b/HarmonyLinkTest/src/main.cpp index 6b7ac05..69c0957 100644 --- a/HarmonyLinkTest/src/main.cpp +++ b/HarmonyLinkTest/src/main.cpp @@ -1,4 +1,16 @@ -// Copyright (C) 2023 Jordon Brooks +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. #include #include From 470f4a318f1c5aaf095c50eceac8e22849c42af0 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Tue, 16 Jan 2024 00:06:06 +0000 Subject: [PATCH 17/54] Add bool is_linux() to the public API for easy access --- HarmonyLinkLib/include/HarmonyLinkLib.h | 2 ++ HarmonyLinkLib/src/HarmonyLinkLib.cpp | 11 +++++++++++ 2 files changed, 13 insertions(+) diff --git a/HarmonyLinkLib/include/HarmonyLinkLib.h b/HarmonyLinkLib/include/HarmonyLinkLib.h index aaa1887..dd6bebd 100644 --- a/HarmonyLinkLib/include/HarmonyLinkLib.h +++ b/HarmonyLinkLib/include/HarmonyLinkLib.h @@ -46,6 +46,8 @@ namespace HarmonyLinkLib { extern "C" HARMONYLINKLIB_API bool get_is_wine(); + extern "C" HARMONYLINKLIB_API bool get_is_linux(); + extern "C" HARMONYLINKLIB_API FCPUInfo* get_cpu_info(); extern "C" HARMONYLINKLIB_API FDevice* get_device_info(); diff --git a/HarmonyLinkLib/src/HarmonyLinkLib.cpp b/HarmonyLinkLib/src/HarmonyLinkLib.cpp index fecfc97..ff05bae 100644 --- a/HarmonyLinkLib/src/HarmonyLinkLib.cpp +++ b/HarmonyLinkLib/src/HarmonyLinkLib.cpp @@ -32,6 +32,17 @@ namespace HarmonyLinkLib return PlatformUtilities->is_running_under_wine(); } + bool get_is_linux() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return false; + } + + return PlatformUtilities->is_linux(); + } + FCPUInfo* get_cpu_info() { if (!PlatformUtilities) From 545815fd6dc9d9d36bedd7add168e65baa315a30 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Tue, 16 Jan 2024 00:09:12 +0000 Subject: [PATCH 18/54] Add initial score-based dock detection This is early development & untested code specifically targeting the steam deck for now until further finalised --- HarmonyLinkLib/include/HarmonyLinkLib.h | 2 + HarmonyLinkLib/src/HarmonyLinkLib.cpp | 11 + .../src/Platform/IPlatformUtilities.cpp | 237 +++++++++++------- .../src/Platform/IPlatformUtilities.h | 11 +- .../src/Platform/Unix/UnixUtilities.cpp | 24 +- .../src/Platform/Unix/UnixUtilities.h | 8 + .../src/Platform/Windows/WindowsUtilities.cpp | 187 +++++++++----- .../src/Platform/Windows/WindowsUtilities.h | 6 + 8 files changed, 336 insertions(+), 150 deletions(-) diff --git a/HarmonyLinkLib/include/HarmonyLinkLib.h b/HarmonyLinkLib/include/HarmonyLinkLib.h index dd6bebd..d6575a5 100644 --- a/HarmonyLinkLib/include/HarmonyLinkLib.h +++ b/HarmonyLinkLib/include/HarmonyLinkLib.h @@ -48,6 +48,8 @@ namespace HarmonyLinkLib extern "C" HARMONYLINKLIB_API bool get_is_linux(); + extern "C" HARMONYLINKLIB_API bool get_is_docked(); + extern "C" HARMONYLINKLIB_API FCPUInfo* get_cpu_info(); extern "C" HARMONYLINKLIB_API FDevice* get_device_info(); diff --git a/HarmonyLinkLib/src/HarmonyLinkLib.cpp b/HarmonyLinkLib/src/HarmonyLinkLib.cpp index ff05bae..91ccc2c 100644 --- a/HarmonyLinkLib/src/HarmonyLinkLib.cpp +++ b/HarmonyLinkLib/src/HarmonyLinkLib.cpp @@ -43,6 +43,17 @@ namespace HarmonyLinkLib return PlatformUtilities->is_linux(); } + bool get_is_docked() + { + if (!PlatformUtilities) + { + std::wcout << "Failed to get platform utilities!\n"; + return false; + } + + return PlatformUtilities->is_docked(); + } + FCPUInfo* get_cpu_info() { if (!PlatformUtilities) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 4475379..8c53695 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -31,106 +31,173 @@ namespace HarmonyLinkLib { static std::shared_ptr INSTANCE = nullptr; -std::shared_ptr& IPlatformUtilities::GetInstance() -{ - if (!INSTANCE) + std::shared_ptr& IPlatformUtilities::GetInstance() { -#if BUILD_WINDOWS - INSTANCE = std::make_shared(); -#elif BUILD_LINUX - INSTANCE = std::make_shared(); -#elif BUILD_MAC - INSTANCE = std::make_shared(); -#elif BUILD_UNIX - INSTANCE = std::make_shared(); -// ... other platform checks -#else - std::wcout << "Platform is not supported.\n" -#endif + if (!INSTANCE) + { + #if BUILD_WINDOWS + INSTANCE = std::make_shared(); + #elif BUILD_LINUX + INSTANCE = std::make_shared(); + #elif BUILD_MAC + INSTANCE = std::make_shared(); + #elif BUILD_UNIX + INSTANCE = std::make_shared(); + // ... other platform checks + #else + std::wcout << "Platform is not supported.\n" + #endif + } + + return INSTANCE; } - - return INSTANCE; -} -bool IPlatformUtilities::is_running_under_wine() -{ - return WineUtilities::is_wine_present(); -} - -bool IPlatformUtilities::is_linux() -{ -#ifdef BUILD_LINUX - return true; -#else - return is_running_under_wine(); -#endif -} - -std::shared_ptr IPlatformUtilities::get_device() -{ - FDevice new_device; - - if (is_linux()) + bool IPlatformUtilities::is_running_under_wine() { - new_device.platform = EPlatform::LINUX; + return WineUtilities::is_wine_present(); } - else + + bool IPlatformUtilities::is_linux() { - new_device.platform = EPlatform::WINDOWS; - } - - const std::shared_ptr battery_status = get_battery_status(); - - if (battery_status && !battery_status->has_battery) - { - new_device.device = EDevice::DESKTOP; - } - else - { - new_device.device = EDevice::LAPTOP; - } - - if (is_steam_deck(new_device)) { - new_device.device = EDevice::STEAM_DECK; - } - return std::make_shared(new_device); -} - -// Helper function to check if the device is a Steam Deck -bool IPlatformUtilities::is_steam_deck(const FDevice& device) { - - // Check if the device is already identified as a Steam Deck - if (device.device == EDevice::STEAM_DECK) { + #ifdef BUILD_LINUX return true; + #else + return is_running_under_wine(); + #endif } - // Check for Steam Deck by OS version - if (const std::shared_ptr version = get_os_version()) { - if (version->variant_id == "steamdeck" && version->name == "SteamOS") { + bool IPlatformUtilities::is_steam_deck() + { + const std::shared_ptr device = get_device(); + + return device && device->device == EDevice::STEAM_DECK; + } + + bool IPlatformUtilities::is_docked() + { + static constexpr uint8_t CHARGING_SCORE = 3; + static constexpr uint8_t EXTERNAL_MONITOR_SCORE = 3; + static constexpr uint8_t KEYBOARD_DETECTION_SCORE = 2; + static constexpr uint8_t CONTROLLER_DETECTION_SCORE = 2; + static constexpr uint8_t FINAL_TARGET_DETECTION_SCORE = 6; + + + const std::shared_ptr device = get_device(); + + if (!device) + { + std::wcout << "Error: failed to get device.\n"; + return false; + } + + if (device->device != EDevice::STEAM_DECK) + { + std::wcout << "Error: Dock detection is currently only supported on Steam Decks.\n"; + return false; + } + + uint8_t score = 0; + + if (is_charging()) + { + score += CHARGING_SCORE; + } + + if (get_is_external_monitor_connected()) + { + score += EXTERNAL_MONITOR_SCORE; + } + + if (get_mouse_keyboard_detected()) + { + score += KEYBOARD_DETECTION_SCORE; + } + + if (get_external_controller_detected()) + { + score += CONTROLLER_DETECTION_SCORE; + } + + return score >= FINAL_TARGET_DETECTION_SCORE; + } + + std::shared_ptr IPlatformUtilities::get_device() + { + FDevice new_device; + + if (is_linux()) + { + new_device.platform = EPlatform::LINUX; + } + else + { + new_device.platform = EPlatform::WINDOWS; + } + + const std::shared_ptr battery_status = get_battery_status(); + + if (battery_status && !battery_status->has_battery) + { + new_device.device = EDevice::DESKTOP; + } + else + { + new_device.device = EDevice::LAPTOP; + } + + if (is_steam_deck_detected(new_device)) { + new_device.device = EDevice::STEAM_DECK; + } + return std::make_shared(new_device); + } + + // Helper function to check if the device is a Steam Deck + bool IPlatformUtilities::is_steam_deck_detected(const FDevice& device) { + + // Check if the device is already identified as a Steam Deck + if (device.device == EDevice::STEAM_DECK) { return true; } - } else { - wprintf(L"OS version information not available.\n"); - } - // Set of known Steam Deck CPU model names - const std::set steam_deck_models = {"amd custom apu 0405" /*, other models... */}; - - // Check for Steam Deck by CPU model name - if (const std::shared_ptr cpu_info = get_cpu_info()) { - const FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); - for (const auto& model : steam_deck_models) { - if (cpu_model_lower == model) { - wprintf(L"Steam Deck detected by CPU model name.\n"); + // Check for Steam Deck by OS version + if (const std::shared_ptr version = get_os_version()) { + if (version->variant_id == "steamdeck" && version->name == "SteamOS") { return true; } + } else { + wprintf(L"OS version information not available.\n"); } - } else { - wprintf(L"CPU information not available.\n"); + + // Set of known Steam Deck CPU model names + const std::set steam_deck_models = {"amd custom apu 0405" /*, other models... */}; + + // Check for Steam Deck by CPU model name + if (const std::shared_ptr cpu_info = get_cpu_info()) { + const FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); + for (const auto& model : steam_deck_models) { + if (cpu_model_lower == model) { + wprintf(L"Steam Deck detected by CPU model name.\n"); + return true; + } + } + } else { + wprintf(L"CPU information not available.\n"); + } + + wprintf(L"Device is not a Steam Deck.\n"); + + return false; } - wprintf(L"Device is not a Steam Deck.\n"); - - return false; -} + bool IPlatformUtilities::is_connected_to_ac() + { + const std::shared_ptr battery = get_battery_status(); + return battery && battery->is_connected_to_ac; + } + + bool IPlatformUtilities::is_charging() + { + const std::shared_ptr battery = get_battery_status(); + return battery && battery->has_battery && battery->is_connected_to_ac; + } } diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h index 933b5db..856e1a4 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h @@ -35,13 +35,22 @@ namespace HarmonyLinkLib // General OS-level functions virtual bool is_running_under_wine(); virtual bool is_linux(); + virtual bool is_steam_deck(); + virtual bool is_docked(); virtual std::shared_ptr get_device(); virtual std::shared_ptr get_cpu_info() = 0; virtual std::shared_ptr get_battery_status() = 0; virtual std::shared_ptr get_os_version() = 0; + virtual bool get_is_external_monitor_connected() = 0; + virtual bool get_mouse_keyboard_detected() = 0; + virtual bool get_external_controller_detected() = 0; + //virtual bool get_is_ethernet_connected() = 0; + //virtual bool get_is_external_input_detected() = 0; - bool is_steam_deck(const FDevice& device); + bool is_steam_deck_detected(const FDevice& device); + bool is_connected_to_ac(); + bool is_charging(); // Add more virtual functions for other OS interactions here }; diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp index 98864a1..63fef64 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp @@ -18,21 +18,43 @@ namespace HarmonyLinkLib { bool UnixUtilities::is_running_under_wine() { - return false; + std::wcout << "This feature is not supported on unix systems yet.\n"; + return false; } std::shared_ptr UnixUtilities::get_cpu_info() { + std::wcout << "This feature is not supported on unix systems yet.\n"; return nullptr; } std::shared_ptr UnixUtilities::get_battery_status() { + std::wcout << "This feature is not supported on unix systems yet.\n"; return nullptr; } std::shared_ptr UnixUtilities::get_os_version() { + std::wcout << "This feature is not supported on unix systems yet.\n"; return nullptr; } + + bool UnixUtilities::get_is_external_monitor_connected() + { + std::wcout << "This feature is not supported on unix-based systems yet.\n"; + return false; + } + + bool UnixUtilities::get_mouse_keyboard_detected() + { + std::wcout << "This feature is not supported on unix-based systems yet.\n"; + return false; + } + + bool UnixUtilities::get_external_controller_detected() + { + std::wcout << "This feature is not supported on unix-based systems yet.\n"; + return false; + } } \ No newline at end of file diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h index c627c0a..7e0fd5a 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h @@ -17,6 +17,8 @@ #include "Platform/IPlatformUtilities.h" namespace HarmonyLinkLib { + // This is more of a "catch all" for all unix-based systems + // that don't have their own implementations. class UnixUtilities : public IPlatformUtilities { public: bool is_running_under_wine() override; @@ -24,6 +26,12 @@ namespace HarmonyLinkLib std::shared_ptr get_cpu_info() override; std::shared_ptr get_battery_status() override; std::shared_ptr get_os_version() override; + + bool get_is_external_monitor_connected() override; + + bool get_mouse_keyboard_detected() override; + + bool get_external_controller_detected() override; // Implementation for other Unix/Linux-specific functions }; diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp index 6185502..f363bd8 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp @@ -17,79 +17,140 @@ #include #include +#include +#pragma comment(lib, "XInput.lib") + #include "Platform/WineUtilities.h" namespace HarmonyLinkLib { std::shared_ptr WindowsUtilities::get_battery_status() -{ - if (is_linux()) { - return WineUtilities::get_battery_status(); - } - FBattery result; - - SYSTEM_POWER_STATUS status; - if (GetSystemPowerStatus(&status)) { - result.has_battery = status.BatteryFlag != 128; // 128 indicates no battery - result.is_connected_to_ac = status.ACLineStatus == 1; - result.battery_percent = result.has_battery ? status.BatteryLifePercent : 0; - } else { - std::wcout << "Failed to get power statistics.\n"; - } - - return std::make_shared(result); -} - -std::shared_ptr WindowsUtilities::get_cpu_info() -{ - if (is_linux()) - { - return WineUtilities::get_cpu_info(); - } - - return {}; -} - -std::shared_ptr WindowsUtilities::get_os_version() -{ - if (is_linux()) - { - return WineUtilities::get_linux_info(); - } - - OSVERSIONINFOEX os_version_info; - ZeroMemory(&os_version_info, sizeof(OSVERSIONINFOEX)); - os_version_info.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX); - - if (!GetVersionEx(reinterpret_cast(&os_version_info))) { - // Handle error if needed - return nullptr; - } - - FOSVerInfo os_version; - - HKEY h_key; - if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, TEXT("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion"), 0, KEY_READ, &h_key) == ERROR_SUCCESS) - { - DWORD dw_size; - DWORD dw_type; - char sz_product_name[256]; - dw_size = sizeof(sz_product_name); - if (RegQueryValueEx(h_key, TEXT("ProductName"), nullptr, &dw_type, reinterpret_cast(sz_product_name), &dw_size) == ERROR_SUCCESS) + if (is_linux()) { - os_version.pretty_name = sz_product_name; + return WineUtilities::get_battery_status(); } - RegCloseKey(h_key); + FBattery result; + + SYSTEM_POWER_STATUS status; + if (GetSystemPowerStatus(&status)) { + result.has_battery = status.BatteryFlag != 128; // 128 indicates no battery + result.is_connected_to_ac = status.ACLineStatus == 1; + result.battery_percent = result.has_battery ? status.BatteryLifePercent : 0; + } else { + std::wcout << "Failed to get power statistics.\n"; + } + + return std::make_shared(result); } - std::stringstream version; - version << os_version_info.dwMajorVersion << "." << os_version_info.dwMinorVersion; - os_version.version_id = version.str(); + std::shared_ptr WindowsUtilities::get_cpu_info() + { + if (is_linux()) + { + return WineUtilities::get_cpu_info(); + } + + return {}; + } - os_version.name = "Windows"; - os_version.version = os_version_info.dwBuildNumber; // Build number as the version + std::shared_ptr WindowsUtilities::get_os_version() + { + if (is_linux()) + { + return WineUtilities::get_linux_info(); + } + + OSVERSIONINFOEX os_version_info; + ZeroMemory(&os_version_info, sizeof(OSVERSIONINFOEX)); + os_version_info.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX); - return std::make_shared(os_version); -} + if (!GetVersionEx(reinterpret_cast(&os_version_info))) { + // Handle error if needed + return nullptr; + } + + FOSVerInfo os_version; + + HKEY h_key; + if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, TEXT("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion"), 0, KEY_READ, &h_key) == ERROR_SUCCESS) + { + DWORD dw_size; + DWORD dw_type; + char sz_product_name[256]; + dw_size = sizeof(sz_product_name); + if (RegQueryValueEx(h_key, TEXT("ProductName"), nullptr, &dw_type, reinterpret_cast(sz_product_name), &dw_size) == ERROR_SUCCESS) + { + os_version.pretty_name = sz_product_name; + } + RegCloseKey(h_key); + } + + std::stringstream version; + version << os_version_info.dwMajorVersion << "." << os_version_info.dwMinorVersion; + os_version.version_id = version.str(); + + os_version.name = "Windows"; + os_version.version = os_version_info.dwBuildNumber; // Build number as the version + + return std::make_shared(os_version); + } + + bool WindowsUtilities::get_is_external_monitor_connected() + { + // SM_CMONITORS returns the count of all display monitors. + const int monitorCount = GetSystemMetrics(SM_CMONITORS); + + // More than one monitor implies an external monitor is connected. + return monitorCount > 1; + } + + bool WindowsUtilities::get_mouse_keyboard_detected() + { + UINT n_devices; + GetRawInputDeviceList(nullptr, &n_devices, sizeof(RAWINPUTDEVICELIST)); + + if (n_devices > 0) { + bool mouse_detected = false; + bool keyboard_detected = false; + + std::vector devices(n_devices); + GetRawInputDeviceList(devices.data(), &n_devices, sizeof(RAWINPUTDEVICELIST)); + + for (const auto& device : devices) { + switch (device.dwType) + { + case RIM_TYPEMOUSE: + mouse_detected = true; + break; + case RIM_TYPEKEYBOARD: + keyboard_detected = true; + break; + + default: + break; + } + } + return mouse_detected && keyboard_detected; + } + return false; + } + + bool WindowsUtilities::get_external_controller_detected() + { + static_assert(XUSER_MAX_COUNT <= UINT8_MAX, "XUSER_MAX_COUNT exceeds uint8_t size"); + + uint8_t connectedGamepads = 0; + + for (DWORD i = 0; i < XUSER_MAX_COUNT; ++i) { + XINPUT_STATE state; + ZeroMemory(&state, sizeof(XINPUT_STATE)); + + if (XInputGetState(i, &state) == ERROR_SUCCESS) { + connectedGamepads++; + } + } + + return connectedGamepads > 1; + } } diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h index 583ca45..c51eacb 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h @@ -26,5 +26,11 @@ namespace HarmonyLinkLib std::shared_ptr get_cpu_info() override; std::shared_ptr get_os_version() override; + + bool get_is_external_monitor_connected() override; + + bool get_mouse_keyboard_detected() override; + + bool get_external_controller_detected() override; }; } From ea7042c9adb3094e0ea1c544115bf98ce919ec2c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Tue, 16 Jan 2024 02:04:22 +0000 Subject: [PATCH 19/54] Improved dock detection --- .../src/Platform/IPlatformUtilities.cpp | 22 ++++-- .../src/Platform/IPlatformUtilities.h | 4 +- .../src/Platform/Unix/UnixUtilities.cpp | 14 +++- .../src/Platform/Unix/UnixUtilities.h | 6 +- .../src/Platform/Windows/WindowsUtilities.cpp | 71 ++++++++++++------- .../src/Platform/Windows/WindowsUtilities.h | 6 +- HarmonyLinkTest/src/main.cpp | 6 ++ 7 files changed, 95 insertions(+), 34 deletions(-) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 8c53695..e5ff858 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -76,10 +76,12 @@ namespace HarmonyLinkLib bool IPlatformUtilities::is_docked() { static constexpr uint8_t CHARGING_SCORE = 3; - static constexpr uint8_t EXTERNAL_MONITOR_SCORE = 3; - static constexpr uint8_t KEYBOARD_DETECTION_SCORE = 2; - static constexpr uint8_t CONTROLLER_DETECTION_SCORE = 2; - static constexpr uint8_t FINAL_TARGET_DETECTION_SCORE = 6; + static constexpr uint8_t EXTERNAL_MONITOR_SCORE = 4; + static constexpr uint8_t STEAM_DECK_RESOLUTION_SCORE = 3; + static constexpr uint8_t KEYBOARD_DETECTION_SCORE = 1; + static constexpr uint8_t MOUSE_DETECTION_SCORE = 2; + static constexpr uint8_t CONTROLLER_DETECTION_SCORE = 3; + static constexpr uint8_t FINAL_TARGET_DETECTION_SCORE = 9; const std::shared_ptr device = get_device(); @@ -108,11 +110,21 @@ namespace HarmonyLinkLib score += EXTERNAL_MONITOR_SCORE; } - if (get_mouse_keyboard_detected()) + if (get_is_steam_deck_native_resolution()) + { + score += STEAM_DECK_RESOLUTION_SCORE; + } + + if (get_keyboard_detected()) { score += KEYBOARD_DETECTION_SCORE; } + if (get_mouse_detected()) + { + score += MOUSE_DETECTION_SCORE; + } + if (get_external_controller_detected()) { score += CONTROLLER_DETECTION_SCORE; diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h index 856e1a4..420edef 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h @@ -43,8 +43,10 @@ namespace HarmonyLinkLib virtual std::shared_ptr get_battery_status() = 0; virtual std::shared_ptr get_os_version() = 0; virtual bool get_is_external_monitor_connected() = 0; - virtual bool get_mouse_keyboard_detected() = 0; + virtual bool get_keyboard_detected() = 0; + virtual bool get_mouse_detected() = 0; virtual bool get_external_controller_detected() = 0; + virtual bool get_is_steam_deck_native_resolution() = 0; //virtual bool get_is_ethernet_connected() = 0; //virtual bool get_is_external_input_detected() = 0; diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp index 63fef64..0d3b777 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.cpp @@ -46,7 +46,13 @@ namespace HarmonyLinkLib return false; } - bool UnixUtilities::get_mouse_keyboard_detected() + bool UnixUtilities::get_keyboard_detected() + { + std::wcout << "This feature is not supported on unix-based systems yet.\n"; + return false; + } + + bool UnixUtilities::get_mouse_detected() { std::wcout << "This feature is not supported on unix-based systems yet.\n"; return false; @@ -57,4 +63,10 @@ namespace HarmonyLinkLib std::wcout << "This feature is not supported on unix-based systems yet.\n"; return false; } + + bool UnixUtilities::get_is_steam_deck_native_resolution() + { + std::wcout << "This feature is not supported on unix-based systems yet.\n"; + return false; + } } \ No newline at end of file diff --git a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h index 7e0fd5a..8a06546 100644 --- a/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h +++ b/HarmonyLinkLib/src/Platform/Unix/UnixUtilities.h @@ -29,9 +29,13 @@ namespace HarmonyLinkLib bool get_is_external_monitor_connected() override; - bool get_mouse_keyboard_detected() override; + bool get_keyboard_detected() override; + + bool get_mouse_detected() override; bool get_external_controller_detected() override; + + bool get_is_steam_deck_native_resolution() override; // Implementation for other Unix/Linux-specific functions }; diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp index f363bd8..dfd7aa8 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.cpp @@ -21,6 +21,7 @@ #pragma comment(lib, "XInput.lib") #include "Platform/WineUtilities.h" +#include namespace HarmonyLinkLib { @@ -105,35 +106,40 @@ namespace HarmonyLinkLib return monitorCount > 1; } - bool WindowsUtilities::get_mouse_keyboard_detected() + bool WindowsUtilities::get_keyboard_detected() { UINT n_devices; - GetRawInputDeviceList(nullptr, &n_devices, sizeof(RAWINPUTDEVICELIST)); + std::vector devices; + + GetRawInputDeviceList(devices.data(), &n_devices, sizeof(RAWINPUTDEVICELIST)); - if (n_devices > 0) { - bool mouse_detected = false; - bool keyboard_detected = false; - - std::vector devices(n_devices); - GetRawInputDeviceList(devices.data(), &n_devices, sizeof(RAWINPUTDEVICELIST)); - - for (const auto& device : devices) { - switch (device.dwType) - { - case RIM_TYPEMOUSE: - mouse_detected = true; - break; - case RIM_TYPEKEYBOARD: - keyboard_detected = true; - break; - - default: - break; - } - } - return mouse_detected && keyboard_detected; + if (n_devices == 0) + { + return false; } - return false; + + return std::any_of(devices.begin(), devices.end(), [](const RAWINPUTDEVICELIST& device) + { + return device.dwType == RIM_TYPEKEYBOARD; + }); + } + + bool WindowsUtilities::get_mouse_detected() + { + UINT n_devices; + std::vector devices; + + GetRawInputDeviceList(devices.data(), &n_devices, sizeof(RAWINPUTDEVICELIST)); + + if (n_devices == 0) + { + return false; + } + + return std::any_of(devices.begin(), devices.end(), [](const RAWINPUTDEVICELIST& device) + { + return device.dwType == RIM_TYPEMOUSE; + }); } bool WindowsUtilities::get_external_controller_detected() @@ -153,4 +159,19 @@ namespace HarmonyLinkLib return connectedGamepads > 1; } + + bool WindowsUtilities::get_is_steam_deck_native_resolution() + { + DEVMODE devMode; + devMode.dmSize = sizeof(DEVMODE); + + // Get the current display settings for the primary monitor + if (EnumDisplaySettings(NULL, ENUM_CURRENT_SETTINGS, &devMode)) { + // Check if the resolution is higher than 800p (1280x800) + if (devMode.dmPelsWidth > 1280 || devMode.dmPelsHeight > 800) { + return true; + } + } + return false; + } } diff --git a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h index c51eacb..809b204 100644 --- a/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h +++ b/HarmonyLinkLib/src/Platform/Windows/WindowsUtilities.h @@ -29,8 +29,12 @@ namespace HarmonyLinkLib bool get_is_external_monitor_connected() override; - bool get_mouse_keyboard_detected() override; + bool get_keyboard_detected() override; + + bool get_mouse_detected() override; bool get_external_controller_detected() override; + + bool get_is_steam_deck_native_resolution() override; }; } diff --git a/HarmonyLinkTest/src/main.cpp b/HarmonyLinkTest/src/main.cpp index 69c0957..e9eaf87 100644 --- a/HarmonyLinkTest/src/main.cpp +++ b/HarmonyLinkTest/src/main.cpp @@ -128,6 +128,12 @@ int main() battery->free(); } + const bool is_docked = HarmonyLinkLib::get_is_docked(); + + const char* dock_check_string = is_docked ? "is" : "isn't"; + + wprintf(L"Device %hs docked\n", dock_check_string); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); } From ce7de29721185ce8fa5181a2e18a7e5c7c40fd24 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 00:54:31 +0100 Subject: [PATCH 20/54] Add Utilities class to add utility functions --- HarmonyLinkLib/CMakeLists.txt | 4 ++ .../src/Platform/IPlatformUtilities.cpp | 12 +++++ HarmonyLinkLib/src/Utilities.cpp | 53 +++++++++++++++++++ HarmonyLinkLib/src/Utilities.h | 30 +++++++++++ 4 files changed, 99 insertions(+) create mode 100644 HarmonyLinkLib/src/Utilities.cpp create mode 100644 HarmonyLinkLib/src/Utilities.h diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 8412f45..10486b1 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -34,11 +34,13 @@ set(COMMON_SOURCES "src/Version.cpp" "src/dllmain.cpp" "src/Platform/WineUtilities.cpp" + "src/Utilities.cpp" ) # Explicitly list include files set(COMMON_INCLUDES "include/Core.h" + "include/Structs/FBattery.h" "include/Structs/FOSVerInfo.h" "include/Structs/FDevice.h" @@ -53,6 +55,8 @@ set(COMMON_INCLUDES "src/Platform/IPlatformUtilities.h" "src/Platform/WineUtilities.h" + + "src//Utilities.h" ) set(WINDOWS_SOURCES diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index e5ff858..90bd62a 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -14,7 +14,9 @@ #include "IPlatformUtilities.h" +#include #include +#include "Utilities.h" #include "WineUtilities.h" #if BUILD_WINDOWS @@ -100,35 +102,45 @@ namespace HarmonyLinkLib uint8_t score = 0; + Utilities::DebugPrint("Detected: ", false); + if (is_charging()) { + Utilities::DebugPrint("Charging, ", false); score += CHARGING_SCORE; } if (get_is_external_monitor_connected()) { + Utilities::DebugPrint("External monitor, ", false); score += EXTERNAL_MONITOR_SCORE; } if (get_is_steam_deck_native_resolution()) { + Utilities::DebugPrint("Non-native resolution, ", false); score += STEAM_DECK_RESOLUTION_SCORE; } if (get_keyboard_detected()) { + Utilities::DebugPrint("keyboard ", false); score += KEYBOARD_DETECTION_SCORE; } if (get_mouse_detected()) { + Utilities::DebugPrint("mouse, ", false); score += MOUSE_DETECTION_SCORE; } if (get_external_controller_detected()) { + Utilities::DebugPrint("external controller, ", false); score += CONTROLLER_DETECTION_SCORE; } + + Utilities::DebugPrint(std::format("Score: {}/{}", score, FINAL_TARGET_DETECTION_SCORE).c_str()); return score >= FINAL_TARGET_DETECTION_SCORE; } diff --git a/HarmonyLinkLib/src/Utilities.cpp b/HarmonyLinkLib/src/Utilities.cpp new file mode 100644 index 0000000..608437c --- /dev/null +++ b/HarmonyLinkLib/src/Utilities.cpp @@ -0,0 +1,53 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "Utilities.h" + +#include + +#include "FString.h" + +void HarmonyLinkLib::Utilities::DebugPrint(const FString& String, bool AddNewline) +{ +#ifdef DEBUG_MODE + std::wcout << String.c_str(); + + if (AddNewline) + { + std::wcout << L"\n"; + } +#endif +} + +void HarmonyLinkLib::Utilities::DebugPrint(const char* String, bool AddNewline) +{ +#ifdef DEBUG_MODE + std::wcout << std::wstring(String, String + std::strlen(String)); + + if (AddNewline) { + std::wcout << L"\n"; + } +#endif +} + +void HarmonyLinkLib::Utilities::DebugPrint(const wchar_t* String, bool AddNewline) +{ +#ifdef DEBUG_MODE + std::wcout << String; + + if (AddNewline) { + std::wcout << L"\n"; + } +#endif +} diff --git a/HarmonyLinkLib/src/Utilities.h b/HarmonyLinkLib/src/Utilities.h new file mode 100644 index 0000000..d6114c8 --- /dev/null +++ b/HarmonyLinkLib/src/Utilities.h @@ -0,0 +1,30 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once + +#include "HarmonyLinkLib.h" + +namespace HarmonyLinkLib +{ + class FString; + + class Utilities + { + public: + static void DebugPrint(const FString& String, bool AddNewline = true); + static void DebugPrint(const char* String, bool AddNewline = true); + static void DebugPrint(const wchar_t* String, bool AddNewline = true); + }; +} From d0e1c3749f31511a67013d1c1c1e7a9c4425e96a Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 00:55:35 +0100 Subject: [PATCH 21/54] Fix debug compile definition not working --- CMakeLists.txt | 2 ++ HarmonyLinkLib/CMakeLists.txt | 4 ---- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 2bf0723..16e76c5 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -14,6 +14,8 @@ else() message(STATUS "Building with unspecified build type") endif() +add_compile_definitions($<$:DEBUG_MODE>) + #set(gtest_force_shared_crt ON CACHE BOOL "" FORCE) # Platform-specific definitions diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 10486b1..138a697 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -118,10 +118,6 @@ target_include_directories(HarmonyLinkLib target_compile_definitions(HarmonyLinkLib PRIVATE HARMONYLINKLIB_EXPORTS) -if(CMAKE_BUILD_TYPE STREQUAL "Debug") - target_compile_definitions(HarmonyLinkLib PRIVATE "DEBUG_MODE") -endif() - # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) string(TOUPPER ${TYPE} TYPE_UPPER) From 270adff68e2260c5b384001dbd71693b7053ec45 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 00:57:46 +0100 Subject: [PATCH 22/54] Add Dev branch to compile check workflow --- .github/workflows/cmake-multi-platform.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml index dd86440..41e82b4 100644 --- a/.github/workflows/cmake-multi-platform.yml +++ b/.github/workflows/cmake-multi-platform.yml @@ -5,9 +5,9 @@ name: CMake on multiple platforms on: workflow_dispatch: push: - branches: [ "Stable" ] + branches: [ "Stable", "Dev" ] pull_request: - branches: [ "Stable" ] + branches: [ "Stable", "Dev" ] jobs: build: From 6e3c2da0a6b2d57b26d591226c5a896675310e9c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 00:57:46 +0100 Subject: [PATCH 23/54] Add Dev branch to compile check workflow (cherry picked from commit 270adff68e2260c5b384001dbd71693b7053ec45) --- .github/workflows/cmake-multi-platform.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml index dd86440..41e82b4 100644 --- a/.github/workflows/cmake-multi-platform.yml +++ b/.github/workflows/cmake-multi-platform.yml @@ -5,9 +5,9 @@ name: CMake on multiple platforms on: workflow_dispatch: push: - branches: [ "Stable" ] + branches: [ "Stable", "Dev" ] pull_request: - branches: [ "Stable" ] + branches: [ "Stable", "Dev" ] jobs: build: From 2ffc6b948a15c50aed1c24cc2b6249e3dd6470cf Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:04:04 +0100 Subject: [PATCH 24/54] Update GitHub Actions to actions/checkout@v4 --- .github/workflows/cmake-multi-platform.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml index 41e82b4..95ddb78 100644 --- a/.github/workflows/cmake-multi-platform.yml +++ b/.github/workflows/cmake-multi-platform.yml @@ -59,7 +59,7 @@ jobs: - os: macos-latest cpp_compiler: cl steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 with: submodules: 'recursive' From 5b34e9de0fee6dcca0e6f3c8c70d2b295263637b Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:05:36 +0100 Subject: [PATCH 25/54] Update CMakeLists to use C++ 20 --- HarmonyLinkLib/CMakeLists.txt | 2 +- HarmonyLinkTest/CMakeLists.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 138a697..76b4ccf 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -24,7 +24,7 @@ endif() configure_file(include/Version.h.in Version.generated.h) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD 20) set(CMAKE_CXX_STANDARD_REQUIRED True) # Explicitly list source files diff --git a/HarmonyLinkTest/CMakeLists.txt b/HarmonyLinkTest/CMakeLists.txt index 5616a24..3b4c7d7 100644 --- a/HarmonyLinkTest/CMakeLists.txt +++ b/HarmonyLinkTest/CMakeLists.txt @@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.10) project(HarmonyLinkTest) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD 20) set(CMAKE_CXX_STANDARD_REQUIRED True) # Automatically add all .cpp and .h/.hpp files in the src directory From 448f0c2124d10e83ee41844d5102435ec116a8ed Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:29:06 +0100 Subject: [PATCH 26/54] Replace std::format with oss fmt library --- HarmonyLinkLib/CMakeLists.txt | 20 +++++++++++++++++++ .../src/Platform/IPlatformUtilities.cpp | 4 ++-- 2 files changed, 22 insertions(+), 2 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 76b4ccf..e551e6c 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -1,6 +1,23 @@ cmake_minimum_required(VERSION 3.10) project(HarmonyLinkLib VERSION 2.0.0) +include(FetchContent) + +FetchContent_Declare( + fmt + GIT_REPOSITORY https://github.com/fmtlib/fmt.git + GIT_TAG 10.2.1 # Specify the desired version of {fmt} +) + +FetchContent_MakeAvailable(fmt) +if(NOT fmt_POPULATED) + FetchContent_Populate(fmt) + # Add fmt but exclude it from the ALL target, reducing IDE clutter + add_subdirectory(${fmt_SOURCE_DIR} ${fmt_BINARY_DIR} EXCLUDE_FROM_ALL) +endif() + +set_target_properties(fmt PROPERTIES FOLDER External) + # Find the current Git branch and the last commit timestamp find_package(Git QUIET) if(GIT_FOUND) @@ -127,3 +144,6 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/${PROJECT_NAME}" ) endforeach() + +# Link fmt library +target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 90bd62a..ecfb670 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -14,7 +14,7 @@ #include "IPlatformUtilities.h" -#include +#include #include #include "Utilities.h" @@ -140,7 +140,7 @@ namespace HarmonyLinkLib score += CONTROLLER_DETECTION_SCORE; } - Utilities::DebugPrint(std::format("Score: {}/{}", score, FINAL_TARGET_DETECTION_SCORE).c_str()); + Utilities::DebugPrint(fmt::format("Score: {}/{}", score, FINAL_TARGET_DETECTION_SCORE).c_str()); return score >= FINAL_TARGET_DETECTION_SCORE; } From e3830ccf3686f31e58ebeca8a6aea7648aee51f1 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:34:16 +0100 Subject: [PATCH 27/54] Enable PIC --- HarmonyLinkLib/CMakeLists.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index e551e6c..a702863 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -18,6 +18,8 @@ endif() set_target_properties(fmt PROPERTIES FOLDER External) +set(CMAKE_POSITION_INDEPENDENT_CODE TRUE) + # Find the current Git branch and the last commit timestamp find_package(Git QUIET) if(GIT_FOUND) From 1b15cd1de1d84774c5deb3c9d81fa54a9caa41e9 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:35:50 +0100 Subject: [PATCH 28/54] enable PIC specifically for fmt --- HarmonyLinkLib/CMakeLists.txt | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index a702863..c36aa39 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -17,8 +17,7 @@ if(NOT fmt_POPULATED) endif() set_target_properties(fmt PROPERTIES FOLDER External) - -set(CMAKE_POSITION_INDEPENDENT_CODE TRUE) +set_target_properties(fmt PROPERTIES POSITION_INDEPENDENT_CODE TRUE) # Find the current Git branch and the last commit timestamp find_package(Git QUIET) From eacab9957851a41c5430565bc87c0129306b09d2 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sun, 7 Apr 2024 01:38:42 +0100 Subject: [PATCH 29/54] switch back to C++ 17 --- HarmonyLinkLib/CMakeLists.txt | 2 +- HarmonyLinkTest/CMakeLists.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index c36aa39..af70787 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -42,7 +42,7 @@ endif() configure_file(include/Version.h.in Version.generated.h) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 20) +set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED True) # Explicitly list source files diff --git a/HarmonyLinkTest/CMakeLists.txt b/HarmonyLinkTest/CMakeLists.txt index 3b4c7d7..5616a24 100644 --- a/HarmonyLinkTest/CMakeLists.txt +++ b/HarmonyLinkTest/CMakeLists.txt @@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.10) project(HarmonyLinkTest) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 20) +set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED True) # Automatically add all .cpp and .h/.hpp files in the src directory From 8c617f8b400b191e5eb58d583896a7b76e431294 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sat, 11 May 2024 22:45:58 +0100 Subject: [PATCH 30/54] Force cpu_model_lower to actually check if its actually lower --- HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index ecfb670..0884ca1 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -199,7 +199,7 @@ namespace HarmonyLinkLib if (const std::shared_ptr cpu_info = get_cpu_info()) { const FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); for (const auto& model : steam_deck_models) { - if (cpu_model_lower == model) { + if (cpu_model_lower == FString::to_lower(model.c_str())) { wprintf(L"Steam Deck detected by CPU model name.\n"); return true; } From e16f008dfc0f19dc4ba0b6e84f3c8485ba4d89a1 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sat, 11 May 2024 22:47:56 +0100 Subject: [PATCH 31/54] Added Steam Deck OLED support --- HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 0884ca1..2f5d6fc 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -193,7 +193,10 @@ namespace HarmonyLinkLib } // Set of known Steam Deck CPU model names - const std::set steam_deck_models = {"amd custom apu 0405" /*, other models... */}; + const std::set steam_deck_models = { + "amd custom apu 0405" // LCD Steam Deck + "amd custom apu 0932", // OLED Steam Deck + }; // Check for Steam Deck by CPU model name if (const std::shared_ptr cpu_info = get_cpu_info()) { From 07f18771175ebd2c14de8a07919bf865c4e422c0 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Sat, 11 May 2024 23:58:06 +0100 Subject: [PATCH 32/54] Rework `is_steam_deck_detected` function to detect unknown models --- HarmonyLinkLib/CMakeLists.txt | 1 + HarmonyLinkLib/include/Enums/EDevice.h | 1 + HarmonyLinkLib/include/Enums/EPlatform.h | 1 + HarmonyLinkLib/include/Enums/ESteamDeck.h | 29 ++++++++ HarmonyLinkLib/include/Structs/FDevice.h | 6 +- .../src/Platform/IPlatformUtilities.cpp | 73 +++++++++++-------- .../src/Platform/IPlatformUtilities.h | 3 +- 7 files changed, 82 insertions(+), 32 deletions(-) create mode 100644 HarmonyLinkLib/include/Enums/ESteamDeck.h diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index af70787..a0dbaad 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -66,6 +66,7 @@ set(COMMON_INCLUDES "include/Enums/EDevice.h" "include/Enums/EPlatform.h" + "include/Enums/ESteamDeck.h" "include/FString.h" "include/HarmonyLinkLib.h" diff --git a/HarmonyLinkLib/include/Enums/EDevice.h b/HarmonyLinkLib/include/Enums/EDevice.h index 31f9bfe..f49c7ec 100644 --- a/HarmonyLinkLib/include/Enums/EDevice.h +++ b/HarmonyLinkLib/include/Enums/EDevice.h @@ -21,6 +21,7 @@ namespace HarmonyLinkLib { enum class EDevice : uint8_t { + UNKNOWN, DESKTOP, LAPTOP, HANDHELD, diff --git a/HarmonyLinkLib/include/Enums/EPlatform.h b/HarmonyLinkLib/include/Enums/EPlatform.h index 66697ee..ffa2be7 100644 --- a/HarmonyLinkLib/include/Enums/EPlatform.h +++ b/HarmonyLinkLib/include/Enums/EPlatform.h @@ -21,6 +21,7 @@ namespace HarmonyLinkLib { enum class EPlatform : uint8_t { + UNKNOWN, WINDOWS, LINUX, MAC, diff --git a/HarmonyLinkLib/include/Enums/ESteamDeck.h b/HarmonyLinkLib/include/Enums/ESteamDeck.h new file mode 100644 index 0000000..9fbad64 --- /dev/null +++ b/HarmonyLinkLib/include/Enums/ESteamDeck.h @@ -0,0 +1,29 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#pragma once + +#include + +// Enum class for representing different types of devices +namespace HarmonyLinkLib +{ + enum class ESteamDeck : uint8_t + { + NONE, // Device is not a steam deck + UNKNOWN, // Device is a steam deck but model cannot be determined + LCD, + OLED, + }; +} diff --git a/HarmonyLinkLib/include/Structs/FDevice.h b/HarmonyLinkLib/include/Structs/FDevice.h index 50a1a5c..b574d6a 100644 --- a/HarmonyLinkLib/include/Structs/FDevice.h +++ b/HarmonyLinkLib/include/Structs/FDevice.h @@ -18,13 +18,15 @@ #include "Enums/EDevice.h" #include "Enums/EPlatform.h" +#include "Enums/ESteamDeck.h" namespace HarmonyLinkLib { // Struct to represent a specific device with both platform and device type struct FDevice : HarmonyLinkStruct { - EPlatform platform; - EDevice device; + EPlatform platform = EPlatform::UNKNOWN; + EDevice device = EDevice::UNKNOWN; + ESteamDeck steam_deck_model = ESteamDeck::NONE; }; } diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 2f5d6fc..735eeab 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -16,6 +16,8 @@ #include #include +#include + #include "Utilities.h" #include "WineUtilities.h" @@ -169,51 +171,64 @@ namespace HarmonyLinkLib new_device.device = EDevice::LAPTOP; } - if (is_steam_deck_detected(new_device)) { + const ESteamDeck steam_deck_model = detect_steam_deck(new_device); + + if (steam_deck_model != ESteamDeck::NONE) { new_device.device = EDevice::STEAM_DECK; + new_device.steam_deck_model = steam_deck_model; } return std::make_shared(new_device); } // Helper function to check if the device is a Steam Deck - bool IPlatformUtilities::is_steam_deck_detected(const FDevice& device) { - + ESteamDeck IPlatformUtilities::detect_steam_deck(const FDevice& device) { // Check if the device is already identified as a Steam Deck - if (device.device == EDevice::STEAM_DECK) { - return true; + if (device.device == EDevice::STEAM_DECK && device.steam_deck_model != ESteamDeck::NONE) { + return device.steam_deck_model; } - // Check for Steam Deck by OS version - if (const std::shared_ptr version = get_os_version()) { - if (version->variant_id == "steamdeck" && version->name == "SteamOS") { - return true; - } + ESteamDeck steam_deck_model = ESteamDeck::NONE; + + // Retrieve and process CPU information + const std::shared_ptr cpu_info = get_cpu_info(); + if (!cpu_info) { + wprintf(L"CPU information not available.\n"); } else { - wprintf(L"OS version information not available.\n"); + // Convert the CPU model name to lower case once + FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); + + // Map of CPU models to their corresponding Steam Deck models + static const std::unordered_map model_map = { + {FString::to_lower("amd custom apu 0405"), ESteamDeck::LCD}, + {FString::to_lower("amd custom apu 0932"), ESteamDeck::OLED} + }; + + auto iterator = model_map.find(cpu_model_lower); + if (iterator != model_map.end()) { + steam_deck_model = iterator->second; + wprintf(L"Steam Deck detected by CPU model name: %hs.\n", cpu_model_lower.c_str()); + } } - // Set of known Steam Deck CPU model names - const std::set steam_deck_models = { - "amd custom apu 0405" // LCD Steam Deck - "amd custom apu 0932", // OLED Steam Deck - }; - - // Check for Steam Deck by CPU model name - if (const std::shared_ptr cpu_info = get_cpu_info()) { - const FString cpu_model_lower = FString::to_lower(cpu_info->Model_Name); - for (const auto& model : steam_deck_models) { - if (cpu_model_lower == FString::to_lower(model.c_str())) { - wprintf(L"Steam Deck detected by CPU model name.\n"); - return true; + // Check for Steam Deck by OS version only if no model has been detected yet + if (steam_deck_model == ESteamDeck::NONE) + { + if (const std::shared_ptr version = get_os_version()) + { + if (version->variant_id == "steamdeck" && version->name == "SteamOS") + { + // Use UNKNOWN if OS matches but CPU model doesn't fit known profiles + steam_deck_model = ESteamDeck::UNKNOWN; + wprintf(L"Steam Deck OS detected but model is unknown.\n"); } } - } else { - wprintf(L"CPU information not available.\n"); + else + { + wprintf(L"OS version information not available.\n"); + } } - wprintf(L"Device is not a Steam Deck.\n"); - - return false; + return steam_deck_model; } bool IPlatformUtilities::is_connected_to_ac() diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h index 420edef..e6f034f 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.h +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.h @@ -14,6 +14,7 @@ #pragma once +#include "Enums/ESteamDeck.h" #include "Structs/FBattery.h" #include "Structs/FCPUInfo.h" #include "Structs/FDevice.h" @@ -50,7 +51,7 @@ namespace HarmonyLinkLib //virtual bool get_is_ethernet_connected() = 0; //virtual bool get_is_external_input_detected() = 0; - bool is_steam_deck_detected(const FDevice& device); + ESteamDeck detect_steam_deck(const FDevice& device); bool is_connected_to_ac(); bool is_charging(); From 2eb90cf0212c2ee29e6f639ba176f562fc4a7e2c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Mon, 13 May 2024 17:08:47 +0100 Subject: [PATCH 33/54] Add ignores for specific build directiries --- .gitignore | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 46fd768..0839667 100644 --- a/.gitignore +++ b/.gitignore @@ -16,4 +16,8 @@ build/** !Images/* !.github/** !HarmonyLinkLib/** -!HarmonyLinkTest/** \ No newline at end of file +!HarmonyLinkTest/** + +# Blacklist specific build directories +linuxbuild/ +build/ From 3f7e6a6a870c6de4433eefe2e3b3108893ed9839 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 16 May 2024 14:19:48 +0100 Subject: [PATCH 34/54] Version Bump --- HarmonyLinkLib/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index a0dbaad..1f7f490 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.10) -project(HarmonyLinkLib VERSION 2.0.0) +project(HarmonyLinkLib VERSION 2.1.0) include(FetchContent) From d6fcb24863e122f83b96ee686ceb34e85dd84d66 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 16 May 2024 14:22:33 +0100 Subject: [PATCH 35/54] Added static library linking --- CMakeLists.txt | 15 ++++- HarmonyLinkLib/CMakeLists.txt | 86 ++++++++++++++++++-------- HarmonyLinkLib/Resources/Version.rc.in | 49 +++++++++++++++ HarmonyLinkLib/include/Core.h | 10 ++- HarmonyLinkLib/include/Version.h.in | 4 ++ HarmonyLinkTest/CMakeLists.txt | 49 +++++++++++---- 6 files changed, 171 insertions(+), 42 deletions(-) create mode 100644 HarmonyLinkLib/Resources/Version.rc.in diff --git a/CMakeLists.txt b/CMakeLists.txt index 16e76c5..02296e9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,3 +1,16 @@ +# Copyright (c) 2024 Jordon Brooks +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + cmake_minimum_required(VERSION 3.10) project(HarmonyLinkProject) @@ -57,7 +70,7 @@ add_subdirectory(HarmonyLinkTest) #add_executable(Testing ${TEST_SOURCES}) # Set HarmonyLinkTest as the default startup project -set_property(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} PROPERTY VS_STARTUP_PROJECT HarmonyLinkTest) +set_property(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} PROPERTY VS_STARTUP_PROJECT HarmonyLinkTestShared) # Link Google Test and HarmonyLink library to the test executable #target_link_libraries(Testing gtest gtest_main gmock HarmonyLinkLib) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index a0dbaad..97ec61a 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -1,3 +1,16 @@ +# Copyright (c) 2024 Jordon Brooks +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + cmake_minimum_required(VERSION 3.10) project(HarmonyLinkLib VERSION 2.0.0) @@ -45,6 +58,16 @@ configure_file(include/Version.h.in Version.generated.h) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED True) +# Define metadata variables +set(FILE_DESCRIPTION "Enhances handheld gaming with intelligent hardware recognition, dynamic adaptability, and robust API access for Windows and Linux, including Steam Deck and Wine support.") +set(INTERNAL_NAME "HarmonyLinkLib") +set(ORIGINAL_FILENAME "HarmonyLinkLib.dll") +set(PRODUCT_NAME "HarmonyLinkLib") +set(COMMENTS "") + +# Configure version.rc file for shared library +configure_file(${CMAKE_CURRENT_SOURCE_DIR}/Resources/Version.rc.in ${CMAKE_CURRENT_BINARY_DIR}/version.rc @ONLY) + # Explicitly list source files set(COMMON_SOURCES "src/Platform/IPlatformUtilities.cpp" @@ -58,24 +81,19 @@ set(COMMON_SOURCES # Explicitly list include files set(COMMON_INCLUDES "include/Core.h" - "include/Structs/FBattery.h" "include/Structs/FOSVerInfo.h" "include/Structs/FDevice.h" "include/Structs/FCPUInfo.h" - "include/Enums/EDevice.h" "include/Enums/EPlatform.h" "include/Enums/ESteamDeck.h" - "include/FString.h" "include/HarmonyLinkLib.h" "include/Version.h" - "src/Platform/IPlatformUtilities.h" "src/Platform/WineUtilities.h" - - "src//Utilities.h" + "src/Utilities.h" ) set(WINDOWS_SOURCES @@ -111,41 +129,55 @@ if(WIN32) message(STATUS "Compiling for Windows...") list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${WINDOWS_SOURCES}) list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${WINDOWS_INCLUDES}) + list(APPEND SHARED_SOURCES ${CMAKE_CURRENT_BINARY_DIR}/version.rc) elseif(UNIX) - message(STATUS "Compiling for Unix-based systems...") - if(APPLE) - message(STATUS "Compiling for Mac...") - list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${MAC_SOURCES}) - list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${MAC_INCLUDES}) - else() - message(STATUS "Compiling for Linux...") - list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${LINUX_SOURCES}) - list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${LINUX_INCLUDES}) - endif() + message(STATUS "Compiling for Unix-based systems...") + if(APPLE) + message(STATUS "Compiling for Mac...") + list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${MAC_SOURCES}) + list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${MAC_INCLUDES}) + else() + message(STATUS "Compiling for Linux...") + list(APPEND LIB_SOURCES ${COMMON_SOURCES} ${LINUX_SOURCES}) + list(APPEND LIB_INCLUDES ${COMMON_INCLUDES} ${LINUX_INCLUDES}) + endif() endif() -# Add library -add_library(HarmonyLinkLib SHARED ${LIB_SOURCES} ${LIB_INCLUDES}) - -target_include_directories(HarmonyLinkLib +# Create the shared library +add_library(HarmonyLinkLibShared SHARED ${LIB_SOURCES} ${SHARED_SOURCES}) +target_include_directories(HarmonyLinkLibShared PRIVATE "${PROJECT_SOURCE_DIR}/src" PUBLIC "${PROJECT_BINARY_DIR}" "${PROJECT_SOURCE_DIR}/include" ) +target_compile_definitions(HarmonyLinkLibShared PRIVATE HARMONYLINKLIB_SHARED) -target_compile_definitions(HarmonyLinkLib PRIVATE HARMONYLINKLIB_EXPORTS) +# Create the static library +add_library(HarmonyLinkLibStatic STATIC ${LIB_SOURCES}) +target_include_directories(HarmonyLinkLibStatic + PRIVATE + "${PROJECT_SOURCE_DIR}/src" + PUBLIC + "${PROJECT_BINARY_DIR}" + "${PROJECT_SOURCE_DIR}/include" +) +target_compile_definitions(HarmonyLinkLibStatic PRIVATE HARMONYLINKLIB_STATIC) # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) string(TOUPPER ${TYPE} TYPE_UPPER) - set_target_properties(${PROJECT_NAME} PROPERTIES - RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" - LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/${PROJECT_NAME}" - ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/${PROJECT_NAME}" + set_target_properties(HarmonyLinkLibShared PROPERTIES + RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/HarmonyLinkLib" + LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/HarmonyLinkLib" + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLib" + ) + set_target_properties(HarmonyLinkLibStatic PROPERTIES + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLibStatic" ) endforeach() -# Link fmt library -target_link_libraries(${PROJECT_NAME} PRIVATE fmt::fmt) +# Link fmt library to both shared and static libraries +target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt) +target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt) diff --git a/HarmonyLinkLib/Resources/Version.rc.in b/HarmonyLinkLib/Resources/Version.rc.in new file mode 100644 index 0000000..1d443f8 --- /dev/null +++ b/HarmonyLinkLib/Resources/Version.rc.in @@ -0,0 +1,49 @@ +// Copyright (c) 2024 Jordon Brooks +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 + +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include +#include + +VS_VERSION_INFO VERSIONINFO + FILEVERSION @PROJECT_VERSION_MAJOR@,@PROJECT_VERSION_MINOR@,@PROJECT_VERSION_PATCH@,0 + PRODUCTVERSION @PROJECT_VERSION_MAJOR@,@PROJECT_VERSION_MINOR@,@PROJECT_VERSION_PATCH@,0 + FILEFLAGSMASK 0x3fL + FILEFLAGS 0x0L + FILEOS VOS_NT_WINDOWS32 + FILETYPE VFT_DLL + FILESUBTYPE 0x0L +{ + BLOCK "StringFileInfo" + { + BLOCK "040904b0" + { + VALUE "CompanyName", "N/A" + VALUE "FileDescription", "@FILE_DESCRIPTION@" + VALUE "FileVersion", "@PROJECT_VERSION_MAJOR@.@PROJECT_VERSION_MINOR@.@PROJECT_VERSION_PATCH@.0" + VALUE "InternalName", "@INTERNAL_NAME@" + VALUE "OriginalFilename", "@ORIGINAL_FILENAME@" + VALUE "ProductName", "@PRODUCT_NAME@" + VALUE "ProductVersion", "@PROJECT_VERSION_MAJOR@.@PROJECT_VERSION_MINOR@.@PROJECT_VERSION_PATCH@.0" + VALUE "Comments", "@COMMENTS@" + VALUE "LegalCopyright", "N/A" + VALUE "LegalTrademarks", "N/A" + VALUE "PrivateBuild", "N/A" + VALUE "SpecialBuild", "N/A" + } + } + BLOCK "VarFileInfo" + { + VALUE "Translation", 0x409, 1200 + } +} diff --git a/HarmonyLinkLib/include/Core.h b/HarmonyLinkLib/include/Core.h index ec6ef9d..94a32d2 100644 --- a/HarmonyLinkLib/include/Core.h +++ b/HarmonyLinkLib/include/Core.h @@ -16,10 +16,14 @@ // Use a preprocessor definition to switch between export and import declarations #ifdef _WIN32 - #ifdef HARMONYLINKLIB_EXPORTS - #define HARMONYLINKLIB_API __declspec(dllexport) + #ifdef HARMONYLINKLIB_STATIC + #define HARMONYLINKLIB_API #else - #define HARMONYLINKLIB_API __declspec(dllimport) + #ifdef HARMONYLINKLIB_SHARED + #define HARMONYLINKLIB_API __declspec(dllexport) + #else + #define HARMONYLINKLIB_API __declspec(dllimport) + #endif #endif #else #define HARMONYLINKLIB_API diff --git a/HarmonyLinkLib/include/Version.h.in b/HarmonyLinkLib/include/Version.h.in index 08881c5..0802c01 100644 --- a/HarmonyLinkLib/include/Version.h.in +++ b/HarmonyLinkLib/include/Version.h.in @@ -23,3 +23,7 @@ #define GIT_BRANCH_NAME "@GIT_BRANCH_NAME@" #define GIT_COMMIT_TIMESTAMP "@GIT_COMMIT_TIMESTAMP@" + + +#include +#include diff --git a/HarmonyLinkTest/CMakeLists.txt b/HarmonyLinkTest/CMakeLists.txt index 5616a24..949ea4f 100644 --- a/HarmonyLinkTest/CMakeLists.txt +++ b/HarmonyLinkTest/CMakeLists.txt @@ -1,3 +1,16 @@ +# Copyright (c) 2024 Jordon Brooks +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + cmake_minimum_required(VERSION 3.10) project(HarmonyLinkTest) @@ -9,23 +22,37 @@ set(CMAKE_CXX_STANDARD_REQUIRED True) file(GLOB_RECURSE TEST_SOURCES "src/*.cpp") file(GLOB_RECURSE TEST_HEADERS "src/*.h" "src/*.hpp") -# Add executable -add_executable(HarmonyLinkTest ${TEST_SOURCES} ${TEST_HEADERS}) +# Add executable for static library +add_executable(HarmonyLinkTestStatic ${TEST_SOURCES} ${TEST_HEADERS}) +target_link_libraries(HarmonyLinkTestStatic PRIVATE HarmonyLinkLibStatic) +target_compile_definitions(HarmonyLinkTestStatic PRIVATE HARMONYLINKLIB_STATIC) -# Link the HarmonyLinkLib with HarmonyLinkTest -target_link_libraries(HarmonyLinkTest PRIVATE HarmonyLinkLib) +# Add executable for shared library +add_executable(HarmonyLinkTestShared ${TEST_SOURCES} ${TEST_HEADERS}) +target_link_libraries(HarmonyLinkTestShared PRIVATE HarmonyLinkLibShared) +target_compile_definitions(HarmonyLinkTestShared PRIVATE HARMONYLINKLIB_SHARED) # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) string(TOUPPER ${TYPE} TYPE_UPPER) - set_target_properties(${PROJECT_NAME} PROPERTIES - RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" - LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" - ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/${PROJECT_NAME}" + + # Static test executable properties + set_target_properties(HarmonyLinkTestStatic PROPERTIES + RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/HarmonyLinkTestStatic" + LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/HarmonyLinkTestStatic" + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkTestStatic" + ) + + # Shared test executable properties + set_target_properties(HarmonyLinkTestShared PROPERTIES + RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/HarmonyLinkTestShared" + LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/HarmonyLinkTestShared" + ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkTestShared" ) endforeach() -add_custom_command(TARGET HarmonyLinkTest POST_BUILD +# Copy the DLL to the executable directory after building the shared test executable +add_custom_command(TARGET HarmonyLinkTestShared POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different - "$" - "$") + "$" + "$") From 5f5e9de4747c6519f76f201d6f317b9e37476b6c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 16 May 2024 14:36:57 +0100 Subject: [PATCH 36/54] Fixed incorrect windows include on Linux systems --- HarmonyLinkLib/include/Version.h.in | 4 ---- 1 file changed, 4 deletions(-) diff --git a/HarmonyLinkLib/include/Version.h.in b/HarmonyLinkLib/include/Version.h.in index 0802c01..08881c5 100644 --- a/HarmonyLinkLib/include/Version.h.in +++ b/HarmonyLinkLib/include/Version.h.in @@ -23,7 +23,3 @@ #define GIT_BRANCH_NAME "@GIT_BRANCH_NAME@" #define GIT_COMMIT_TIMESTAMP "@GIT_COMMIT_TIMESTAMP@" - - -#include -#include From 6f5f8e7076e4626cf2f1112ab9076d4495ed1824 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 16 May 2024 23:51:01 +0100 Subject: [PATCH 37/54] Fix FMT library issues --- HarmonyLinkLib/CMakeLists.txt | 32 ++++++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 6727506..41e608a 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -16,6 +16,7 @@ project(HarmonyLinkLib VERSION 2.1.0) include(FetchContent) +# Fetch fmt library FetchContent_Declare( fmt GIT_REPOSITORY https://github.com/fmtlib/fmt.git @@ -23,11 +24,6 @@ FetchContent_Declare( ) FetchContent_MakeAvailable(fmt) -if(NOT fmt_POPULATED) - FetchContent_Populate(fmt) - # Add fmt but exclude it from the ALL target, reducing IDE clutter - add_subdirectory(${fmt_SOURCE_DIR} ${fmt_BINARY_DIR} EXCLUDE_FROM_ALL) -endif() set_target_properties(fmt PROPERTIES FOLDER External) set_target_properties(fmt PROPERTIES POSITION_INDEPENDENT_CODE TRUE) @@ -55,7 +51,7 @@ endif() configure_file(include/Version.h.in Version.generated.h) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD 20) set(CMAKE_CXX_STANDARD_REQUIRED True) # Define metadata variables @@ -96,6 +92,23 @@ set(COMMON_INCLUDES "src/Utilities.h" ) +# Adding fmt headers explicitly +set(FMT_HEADERS + "${fmt_SOURCE_DIR}/include/fmt/args.h" + "${fmt_SOURCE_DIR}/include/fmt/chrono.h" + "${fmt_SOURCE_DIR}/include/fmt/color.h" + "${fmt_SOURCE_DIR}/include/fmt/compile.h" + "${fmt_SOURCE_DIR}/include/fmt/core.h" + "${fmt_SOURCE_DIR}/include/fmt/format.h" + "${fmt_SOURCE_DIR}/include/fmt/format-inl.h" + "${fmt_SOURCE_DIR}/include/fmt/os.h" + "${fmt_SOURCE_DIR}/include/fmt/ostream.h" + "${fmt_SOURCE_DIR}/include/fmt/printf.h" + "${fmt_SOURCE_DIR}/include/fmt/ranges.h" + "${fmt_SOURCE_DIR}/include/fmt/std.h" + "${fmt_SOURCE_DIR}/include/fmt/xchar.h" +) + set(WINDOWS_SOURCES "src/Platform/Windows/WindowsUtilities.cpp" ) @@ -165,6 +178,9 @@ target_include_directories(HarmonyLinkLibStatic ) target_compile_definitions(HarmonyLinkLibStatic PRIVATE HARMONYLINKLIB_STATIC) +# Include fmt headers +target_include_directories(HarmonyLinkLibStatic PUBLIC ${FMT_HEADERS}) + # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) string(TOUPPER ${TYPE} TYPE_UPPER) @@ -179,5 +195,5 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) endforeach() # Link fmt library to both shared and static libraries -target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt) -target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt) +target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt-header-only) +target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt-header-only) From ff303b1277a07910985f8f3b0643dce8f28e36de Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 16 May 2024 23:54:22 +0100 Subject: [PATCH 38/54] Version bump --- HarmonyLinkLib/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 41e608a..28fdbd2 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -12,7 +12,7 @@ # limitations under the License. cmake_minimum_required(VERSION 3.10) -project(HarmonyLinkLib VERSION 2.1.0) +project(HarmonyLinkLib VERSION 2.1.1) include(FetchContent) From fa3c03340a6c09aa0ecf16bb4b0cec07d0e2caa3 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 17 May 2024 01:12:12 +0100 Subject: [PATCH 39/54] Fix Unreal Engine Compile error for Linux builds --- HarmonyLinkLib/CMakeLists.txt | 33 ++++++++++++-------------- HarmonyLinkLib/include/Enums/EDevice.h | 3 +++ 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 28fdbd2..ab02348 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -51,7 +51,7 @@ endif() configure_file(include/Version.h.in Version.generated.h) # Specify the C++ standard -set(CMAKE_CXX_STANDARD 20) +set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED True) # Define metadata variables @@ -94,19 +94,7 @@ set(COMMON_INCLUDES # Adding fmt headers explicitly set(FMT_HEADERS - "${fmt_SOURCE_DIR}/include/fmt/args.h" - "${fmt_SOURCE_DIR}/include/fmt/chrono.h" - "${fmt_SOURCE_DIR}/include/fmt/color.h" - "${fmt_SOURCE_DIR}/include/fmt/compile.h" - "${fmt_SOURCE_DIR}/include/fmt/core.h" - "${fmt_SOURCE_DIR}/include/fmt/format.h" - "${fmt_SOURCE_DIR}/include/fmt/format-inl.h" - "${fmt_SOURCE_DIR}/include/fmt/os.h" - "${fmt_SOURCE_DIR}/include/fmt/ostream.h" - "${fmt_SOURCE_DIR}/include/fmt/printf.h" - "${fmt_SOURCE_DIR}/include/fmt/ranges.h" - "${fmt_SOURCE_DIR}/include/fmt/std.h" - "${fmt_SOURCE_DIR}/include/fmt/xchar.h" + "${fmt_SOURCE_DIR}/include/fmt" ) set(WINDOWS_SOURCES @@ -179,7 +167,7 @@ target_include_directories(HarmonyLinkLibStatic target_compile_definitions(HarmonyLinkLibStatic PRIVATE HARMONYLINKLIB_STATIC) # Include fmt headers -target_include_directories(HarmonyLinkLibStatic PUBLIC ${FMT_HEADERS}) +target_include_directories(HarmonyLinkLibStatic PRIVATE ${FMT_HEADERS}) # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) @@ -194,6 +182,15 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) ) endforeach() -# Link fmt library to both shared and static libraries -target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt-header-only) -target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt-header-only) +# Link the fmt library and standard library +target_link_libraries(HarmonyLinkLibStatic + PUBLIC + fmt + stdc++fs +) + +target_link_libraries(HarmonyLinkLibShared + PUBLIC + fmt + stdc++fs +) diff --git a/HarmonyLinkLib/include/Enums/EDevice.h b/HarmonyLinkLib/include/Enums/EDevice.h index f49c7ec..c11919d 100644 --- a/HarmonyLinkLib/include/Enums/EDevice.h +++ b/HarmonyLinkLib/include/Enums/EDevice.h @@ -14,6 +14,9 @@ #pragma once +// Undefine the LINUX macro to avoid conflicts with the enum definition. +#undef LINUX + #include // Enum class for representing different types of devices From 5ac5d8b025548dde906876f1d36b5ab2f2cf1fa4 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 17 May 2024 01:16:16 +0100 Subject: [PATCH 40/54] Remove Macos from github actions workflow --- .github/workflows/cmake-multi-platform.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml index 95ddb78..3b1b52a 100644 --- a/.github/workflows/cmake-multi-platform.yml +++ b/.github/workflows/cmake-multi-platform.yml @@ -24,7 +24,7 @@ jobs: # # To add more build types (Release, Debug, RelWithDebInfo, etc.) customize the build_type list. matrix: - os: [ubuntu-latest, windows-latest, macos-latest] + os: [ubuntu-latest, windows-latest] # macos-latest build_type: [Release] c_compiler: [gcc, clang, cl] cpp_compiler: [g++, clang++, cl] @@ -50,14 +50,14 @@ jobs: c_compiler: cl - os: ubuntu-latest cpp_compiler: cl - - os: macos-latest - c_compiler: gcc - - os: macos-latest - cpp_compiler: g++ - - os: macos-latest - c_compiler: cl - - os: macos-latest - cpp_compiler: cl + #- os: macos-latest + # c_compiler: gcc + #- os: macos-latest + # cpp_compiler: g++ + #- os: macos-latest + # c_compiler: cl + #- os: macos-latest + # cpp_compiler: cl steps: - uses: actions/checkout@v4 with: From 5ed3a257a7a156ea9e3c32bbe4316a755a143e2c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 17 May 2024 01:18:05 +0100 Subject: [PATCH 41/54] Forgot mac option --- .github/workflows/cmake-multi-platform.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/cmake-multi-platform.yml b/.github/workflows/cmake-multi-platform.yml index 3b1b52a..6c5b9f7 100644 --- a/.github/workflows/cmake-multi-platform.yml +++ b/.github/workflows/cmake-multi-platform.yml @@ -38,9 +38,9 @@ jobs: - os: ubuntu-latest c_compiler: clang cpp_compiler: clang++ - - os: macos-latest - c_compiler: clang - cpp_compiler: clang++ + #- os: macos-latest + # c_compiler: clang + # cpp_compiler: clang++ exclude: - os: windows-latest c_compiler: gcc From 80d1a0323120675246adae69af61392001dd5f49 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 17 May 2024 01:25:03 +0100 Subject: [PATCH 42/54] Fixed Windows Includes --- HarmonyLinkLib/CMakeLists.txt | 34 +++++++++++++++++++++++----------- 1 file changed, 23 insertions(+), 11 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index ab02348..60a7b26 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -182,15 +182,27 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) ) endforeach() -# Link the fmt library and standard library -target_link_libraries(HarmonyLinkLibStatic - PUBLIC - fmt - stdc++fs -) +# Link the fmt library and standard library conditionally +if (UNIX) + target_link_libraries(HarmonyLinkLibStatic + PUBLIC + fmt + stdc++fs + ) -target_link_libraries(HarmonyLinkLibShared - PUBLIC - fmt - stdc++fs -) + target_link_libraries(HarmonyLinkLibShared + PUBLIC + fmt + stdc++fs + ) +elseif (WIN32) + target_link_libraries(HarmonyLinkLibStatic + PUBLIC + fmt + ) + + target_link_libraries(HarmonyLinkLibShared + PUBLIC + fmt + ) +endif() From fa0e30987546012acff3f639d9b6e7c1d5f49e96 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 17 May 2024 01:30:25 +0100 Subject: [PATCH 43/54] Fix includes --- HarmonyLinkLib/CMakeLists.txt | 27 +++++---------------------- 1 file changed, 5 insertions(+), 22 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 60a7b26..03440bf 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -182,27 +182,10 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) ) endforeach() -# Link the fmt library and standard library conditionally +target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt) +target_link_libraries(HarmonyLinkLibShared PRIVATE fmt) + if (UNIX) - target_link_libraries(HarmonyLinkLibStatic - PUBLIC - fmt - stdc++fs - ) - - target_link_libraries(HarmonyLinkLibShared - PUBLIC - fmt - stdc++fs - ) -elseif (WIN32) - target_link_libraries(HarmonyLinkLibStatic - PUBLIC - fmt - ) - - target_link_libraries(HarmonyLinkLibShared - PUBLIC - fmt - ) + target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) + target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) endif() From 18129ac7c25c8592a5b3a11bcac116b928efdeab Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Wed, 22 May 2024 18:56:31 +0100 Subject: [PATCH 44/54] Ignore Idea folder --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 0839667..2e489f4 100644 --- a/.gitignore +++ b/.gitignore @@ -21,3 +21,4 @@ build/** # Blacklist specific build directories linuxbuild/ build/ +.idea/ From 7dbe088577b6b78414a61d9d5878e910f2f142ce Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Wed, 22 May 2024 18:59:53 +0100 Subject: [PATCH 45/54] Forgot to add semi-colon to unsupported platform message --- HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp index 735eeab..555cc10 100644 --- a/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/IPlatformUtilities.cpp @@ -49,7 +49,7 @@ namespace HarmonyLinkLib INSTANCE = std::make_shared(); // ... other platform checks #else - std::wcout << "Platform is not supported.\n" + std::wcout << "Platform is not supported.\n"; #endif } From 53f661ece8b43d22a08a3ed97ce37d35fb0e65f2 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 24 May 2024 21:05:34 +0100 Subject: [PATCH 46/54] Fix fmt not being included in library --- HarmonyLinkLib/CMakeLists.txt | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 03440bf..eb67f49 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -92,11 +92,6 @@ set(COMMON_INCLUDES "src/Utilities.h" ) -# Adding fmt headers explicitly -set(FMT_HEADERS - "${fmt_SOURCE_DIR}/include/fmt" -) - set(WINDOWS_SOURCES "src/Platform/Windows/WindowsUtilities.cpp" ) @@ -166,9 +161,6 @@ target_include_directories(HarmonyLinkLibStatic ) target_compile_definitions(HarmonyLinkLibStatic PRIVATE HARMONYLINKLIB_STATIC) -# Include fmt headers -target_include_directories(HarmonyLinkLibStatic PRIVATE ${FMT_HEADERS}) - # Set output directories for all build types foreach(TYPE IN ITEMS DEBUG RELEASE) string(TOUPPER ${TYPE} TYPE_UPPER) @@ -182,8 +174,9 @@ foreach(TYPE IN ITEMS DEBUG RELEASE) ) endforeach() -target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt) -target_link_libraries(HarmonyLinkLibShared PRIVATE fmt) +# Link fmt to HarmonyLinkLib +target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt-header-only) +target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt-header-only) if (UNIX) target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) From 810cea013ea74369664f9709e0024d55e8e756f9 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 24 May 2024 21:08:11 +0100 Subject: [PATCH 47/54] Version Bump --- HarmonyLinkLib/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index eb67f49..7146d8e 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -12,7 +12,7 @@ # limitations under the License. cmake_minimum_required(VERSION 3.10) -project(HarmonyLinkLib VERSION 2.1.1) +project(HarmonyLinkLib VERSION 2.1.2) include(FetchContent) From f25ca44f03cef8667052fb2f0a284fde471045e2 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Mon, 27 May 2024 19:09:17 +0100 Subject: [PATCH 48/54] Linux compile working --- .gitignore | 4 ++ Compile.bat | 68 ++++++++++++++++++++++++++++++++ Compile.sh | 73 +++++++++++++++++++++++++++++++++++ HarmonyLinkLib/CMakeLists.txt | 16 +++++++- HarmonyLinkLib/include/Core.h | 12 +++++- 5 files changed, 169 insertions(+), 4 deletions(-) create mode 100644 Compile.bat create mode 100644 Compile.sh diff --git a/.gitignore b/.gitignore index 2e489f4..a7fdac2 100644 --- a/.gitignore +++ b/.gitignore @@ -22,3 +22,7 @@ build/** linuxbuild/ build/ .idea/ +winbuild/ + +!Compile.sh +!Compile.bat diff --git a/Compile.bat b/Compile.bat new file mode 100644 index 0000000..ccad60c --- /dev/null +++ b/Compile.bat @@ -0,0 +1,68 @@ +@echo off +setlocal enabledelayedexpansion + +REM Clear the screen +cls + +REM Define the color codes +set GREEN= +set NC= + +REM Prompt the user to choose a compiler +echo %GREEN%Select the compiler to use:%NC% +echo 1^ ) MSBuild (default) +echo 2^ ) MinGW +echo 3^ ) Ninja +set /p choice=Enter the number of your choice: + +REM Set the generator and compiler based on the user's choice +if "%choice%"=="2" ( + set "GENERATOR=MinGW Makefiles" + set "COMPILER_OPTION=-DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++" +) else if "%choice%"=="3" ( + set "GENERATOR=Ninja" + set "COMPILER_OPTION=" +) else ( + set "GENERATOR=Visual Studio 17 2022" + set "COMPILER_OPTION=-A x64" + set "choice=1" +) + +echo Using generator: %GENERATOR% + +REM Prompt the user to choose a build type +echo %GREEN%Select the build type:%NC% +echo 1^ ) Release (default) +echo 2^ ) Debug +set /p build_choice=Enter the number of your choice: + +REM Set the build type based on the user's choice +if "%build_choice%"=="2" ( + set "BUILD_TYPE=Debug" +) else ( + set "BUILD_TYPE=Release" +) + +echo Build type: %BUILD_TYPE% + +REM Create the build directory if it doesn't exist +if not exist "winbuild" ( + mkdir winbuild +) + +cd winbuild + +REM Get the number of processors +for /f "tokens=2 delims==" %%a in ('wmic cpu get NumberOfLogicalProcessors /value') do set "NUM_PROCESSORS=%%a" + +REM Run CMake with the selected generator and build type +cmake -G "%GENERATOR%" %COMPILER_OPTION% -DCMAKE_BUILD_TYPE=%BUILD_TYPE% .. + +REM Build the project +if "%choice%"=="1" ( + cmake --build . --config %BUILD_TYPE% -- /m:%NUM_PROCESSORS% +) else ( + cmake --build . --config %BUILD_TYPE% -- -j %NUM_PROCESSORS% +) + +cd .. diff --git a/Compile.sh b/Compile.sh new file mode 100644 index 0000000..c8d82ea --- /dev/null +++ b/Compile.sh @@ -0,0 +1,73 @@ +#!/bin/sh + +set -e + +clear + +# Define the color codes +GREEN='\033[0;32m' +NC='\033[0m' # No Color + +# Prompt the user to choose a compiler +echo "${GREEN}Select the compiler to use:${NC}" +echo "1) g++ (default)" +echo "2) clang++" +echo "3) clang++ 15" +echo "4) clang++ 16" +read -p "Enter the number of your choice: " choice + +# Set the compiler based on the user's choice +case $choice in + 2) + C_COMPILER=clang + CXX_COMPILER=clang++ + ;; + 3) + C_COMPILER=clang-15 + CXX_COMPILER=clang++-15 + ;; + 4) + C_COMPILER=clang-16 + CXX_COMPILER=clang++-16 + ;; + *) + C_COMPILER=gcc + CXX_COMPILER=g++ + ;; +esac + +echo "Using C compiler: $C_COMPILER" +echo "Using C++ compiler: $CXX_COMPILER" + +# Prompt the user to choose a build type +echo "${GREEN}Select the build type:${NC}" +echo "1) Release (default)" +echo "2) Debug" +read -p "Enter the number of your choice: " build_choice + +# Set the build type based on the user's choice +case $build_choice in + 2) + BUILD_TYPE=Debug + ;; + *) + BUILD_TYPE=Release + ;; +esac + +echo "Build type: $BUILD_TYPE" + +# Create the build directory if it doesn't exist +if [ ! -d "linuxbuild" ]; then + mkdir linuxbuild +fi + +cd linuxbuild + +# Run CMake with the selected compiler and build type +cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_C_COMPILER=$C_COMPILER -DCMAKE_CXX_COMPILER=$CXX_COMPILER .. + +# Build the project +cmake --build . --config $BUILD_TYPE --clean-first -j 15 --verbose + +cd .. diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 7146d8e..eba9442 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -120,6 +120,18 @@ set(MAC_INCLUDES "src/Platform/Unix/UnixUtilities.h" ) +# Platform-specific definitions +if(WIN32) + add_definitions(-DBUILD_WINDOWS) +elseif(UNIX) + if(APPLE) + add_definitions(-DBUILD_MACOS) + else() + add_definitions(-DBUILD_LINUX) + endif() + add_definitions(-DBUILD_UNIX) +endif() + # Platform-specific definitions if(WIN32) message(STATUS "Compiling for Windows...") @@ -140,7 +152,7 @@ elseif(UNIX) endif() # Create the shared library -add_library(HarmonyLinkLibShared SHARED ${LIB_SOURCES} ${SHARED_SOURCES}) +add_library(HarmonyLinkLibShared SHARED ${LIB_SOURCES} ${SHARED_SOURCES} ${LIB_INCLUDES}) target_include_directories(HarmonyLinkLibShared PRIVATE "${PROJECT_SOURCE_DIR}/src" @@ -151,7 +163,7 @@ target_include_directories(HarmonyLinkLibShared target_compile_definitions(HarmonyLinkLibShared PRIVATE HARMONYLINKLIB_SHARED) # Create the static library -add_library(HarmonyLinkLibStatic STATIC ${LIB_SOURCES}) +add_library(HarmonyLinkLibStatic STATIC ${LIB_SOURCES} ${LIB_INCLUDES}) target_include_directories(HarmonyLinkLibStatic PRIVATE "${PROJECT_SOURCE_DIR}/src" diff --git a/HarmonyLinkLib/include/Core.h b/HarmonyLinkLib/include/Core.h index 94a32d2..90babed 100644 --- a/HarmonyLinkLib/include/Core.h +++ b/HarmonyLinkLib/include/Core.h @@ -15,7 +15,7 @@ #pragma once // Use a preprocessor definition to switch between export and import declarations -#ifdef _WIN32 +#ifdef BUILD_WINDOWS #ifdef HARMONYLINKLIB_STATIC #define HARMONYLINKLIB_API #else @@ -26,5 +26,13 @@ #endif #endif #else - #define HARMONYLINKLIB_API + #ifdef HARMONYLINKLIB_SHARED + #ifdef __clang__ + #define HARMONYLINKLIB_API __attribute__((visibility("default"))) + #else + #define HARMONYLINKLIB_API + #endif + #else + #define HARMONYLINKLIB_API + #endif #endif From daa49af2476b0733dd4f67897958e7d621d6cb36 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Fri, 31 May 2024 23:43:22 +0100 Subject: [PATCH 49/54] Working in UE4 --- .gitignore | 1 + HarmonyLinkLib/CMakeLists.txt | 1 - HarmonyLinkLib/include/HarmonyLinkLib.h | 16 ++++--- HarmonyLinkLib/src/HarmonyLinkLib.cpp | 13 ++++-- HarmonyLinkLib/src/dllmain.cpp | 61 ------------------------- HarmonyLinkTest/src/main.cpp | 10 +++- 6 files changed, 29 insertions(+), 73 deletions(-) delete mode 100644 HarmonyLinkLib/src/dllmain.cpp diff --git a/.gitignore b/.gitignore index a7fdac2..2e552b2 100644 --- a/.gitignore +++ b/.gitignore @@ -26,3 +26,4 @@ winbuild/ !Compile.sh !Compile.bat +HarmonyLinkLib/.vscode/ diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index eba9442..e61dfb3 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -69,7 +69,6 @@ set(COMMON_SOURCES "src/Platform/IPlatformUtilities.cpp" "src/HarmonyLinkLib.cpp" "src/Version.cpp" - "src/dllmain.cpp" "src/Platform/WineUtilities.cpp" "src/Utilities.cpp" ) diff --git a/HarmonyLinkLib/include/HarmonyLinkLib.h b/HarmonyLinkLib/include/HarmonyLinkLib.h index d6575a5..0298e2d 100644 --- a/HarmonyLinkLib/include/HarmonyLinkLib.h +++ b/HarmonyLinkLib/include/HarmonyLinkLib.h @@ -44,17 +44,19 @@ class IPlatformUtilities; namespace HarmonyLinkLib { - extern "C" HARMONYLINKLIB_API bool get_is_wine(); + HARMONYLINKLIB_API bool HL_Init(); - extern "C" HARMONYLINKLIB_API bool get_is_linux(); + HARMONYLINKLIB_API bool get_is_wine(); - extern "C" HARMONYLINKLIB_API bool get_is_docked(); + HARMONYLINKLIB_API bool get_is_linux(); - extern "C" HARMONYLINKLIB_API FCPUInfo* get_cpu_info(); + HARMONYLINKLIB_API bool get_is_docked(); - extern "C" HARMONYLINKLIB_API FDevice* get_device_info(); + HARMONYLINKLIB_API FCPUInfo* get_cpu_info(); - extern "C" HARMONYLINKLIB_API FOSVerInfo* get_os_version(); + HARMONYLINKLIB_API FDevice* get_device_info(); + + HARMONYLINKLIB_API FOSVerInfo* get_os_version(); - extern "C" HARMONYLINKLIB_API FBattery* get_battery_status(); + HARMONYLINKLIB_API FBattery* get_battery_status(); } diff --git a/HarmonyLinkLib/src/HarmonyLinkLib.cpp b/HarmonyLinkLib/src/HarmonyLinkLib.cpp index 91ccc2c..f57feac 100644 --- a/HarmonyLinkLib/src/HarmonyLinkLib.cpp +++ b/HarmonyLinkLib/src/HarmonyLinkLib.cpp @@ -16,10 +16,19 @@ #include #include "Platform/IPlatformUtilities.h" +#include "Version.h" namespace HarmonyLinkLib { - std::shared_ptr PlatformUtilities = IPlatformUtilities::GetInstance(); + std::shared_ptr PlatformUtilities = nullptr; + + bool HL_Init() + { + std::wcout << "HarmonyLink V" << version::ToString().c_str() << " Copyright (C) 2023 Jordon Brooks\n"; + PlatformUtilities = IPlatformUtilities::GetInstance(); + + return PlatformUtilities != nullptr; + } bool get_is_wine() { @@ -92,8 +101,6 @@ namespace HarmonyLinkLib FOSVerInfo* get_os_version() { - - if (!PlatformUtilities) { std::wcout << "Failed to get platform utilities!\n"; diff --git a/HarmonyLinkLib/src/dllmain.cpp b/HarmonyLinkLib/src/dllmain.cpp deleted file mode 100644 index 5e6df48..0000000 --- a/HarmonyLinkLib/src/dllmain.cpp +++ /dev/null @@ -1,61 +0,0 @@ -// Copyright (c) 2024 Jordon Brooks -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 - -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -#include -#include "Version.h" - -namespace HarmonyLinkLib -{ - void HarmonyLinkInit() - { - std::wcout << "HarmonyLink V" << version::ToString().c_str() << " Copyright (C) 2023 Jordon Brooks\n"; - } -} - - -#if BUILD_WINDOWS -#include - -// Standard DLL entry point -BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) { - switch (fdwReason) { - case DLL_PROCESS_ATTACH: - // Code to run when the DLL is loaded - HarmonyLinkLib::HarmonyLinkInit(); - break; - case DLL_THREAD_ATTACH: - // Code to run when a thread is created during the DLL's lifetime - case DLL_THREAD_DETACH: - // Code to run when a thread ends normally. - case DLL_PROCESS_DETACH: - // Code to run when the DLL is unloaded - default: - break; - } - return TRUE; // Successful DLL_PROCESS_ATTACH. -} -#endif - -#if BUILD_UNIX -__attribute__((constructor)) -static void onLibraryLoad() { - // Code to run when the library is loaded - HarmonyLinkLib::HarmonyLinkInit(); -} - -__attribute__((destructor)) -static void onLibraryUnload() { - // Code to run when the library is unloaded -} -#endif diff --git a/HarmonyLinkTest/src/main.cpp b/HarmonyLinkTest/src/main.cpp index e9eaf87..d4d2d29 100644 --- a/HarmonyLinkTest/src/main.cpp +++ b/HarmonyLinkTest/src/main.cpp @@ -85,10 +85,18 @@ void checkForQuit() { int main() { - std::cout << "Hello, World!" << '\n'; + std::cout << "Hello, World!\n"; std::thread inputThread(checkForQuit); + if (!HarmonyLinkLib::HL_Init()) + { + std::cout << "Failed to init HarmonyLinkLib\n"; + return 1; + } + + std::cout << "HarmonyLinkLib successfully initialised!\n"; + const bool isWine = HarmonyLinkLib::get_is_wine(); const char* test = isWine ? "is" : "isn't"; From 9a1e6f24b1ddf2a66e3d7a6cf3388fb9bc86e15e Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 6 Jun 2024 16:04:11 +0100 Subject: [PATCH 50/54] Fix clang compiler error --- CMakeLists.txt | 12 +++---- HarmonyLinkLib/CMakeLists.txt | 64 ++++++++++++++++++++++++++++------- 2 files changed, 57 insertions(+), 19 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 02296e9..a394d22 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -44,12 +44,12 @@ elseif(UNIX) endif() # Set global output directories for all build types -foreach(TYPE IN ITEMS DEBUG RELEASE) - string(TOUPPER ${TYPE} TYPE_UPPER) - set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}") - set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}") - set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}") -endforeach() +#foreach(TYPE IN ITEMS DEBUG RELEASE) +# string(TOUPPER ${TYPE} TYPE_UPPER) +# set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}") +# set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}") +# set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}") +#endforeach() # Add the library and executable directories diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index e61dfb3..2e2ed12 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -12,7 +12,7 @@ # limitations under the License. cmake_minimum_required(VERSION 3.10) -project(HarmonyLinkLib VERSION 2.1.2) +project(HarmonyLinkLib VERSION 2.1.2 LANGUAGES CXX) include(FetchContent) @@ -150,6 +150,14 @@ elseif(UNIX) endif() endif() +# Detect the compiler name +get_filename_component(COMPILER_NAME ${CMAKE_CXX_COMPILER} NAME) + +# Replace forbidden characters in file names (optional, if needed) +string(REPLACE "." "_" COMPILER_NAME ${COMPILER_NAME}) +string(REPLACE "/" "_" COMPILER_NAME ${COMPILER_NAME}) +string(REPLACE "\\" "_" COMPILER_NAME ${COMPILER_NAME}) + # Create the shared library add_library(HarmonyLinkLibShared SHARED ${LIB_SOURCES} ${SHARED_SOURCES} ${LIB_INCLUDES}) target_include_directories(HarmonyLinkLibShared @@ -160,6 +168,7 @@ target_include_directories(HarmonyLinkLibShared "${PROJECT_SOURCE_DIR}/include" ) target_compile_definitions(HarmonyLinkLibShared PRIVATE HARMONYLINKLIB_SHARED) +set_target_properties(HarmonyLinkLibShared PROPERTIES OUTPUT_NAME "HarmonyLinkLibShared_${COMPILER_NAME}") # Create the static library add_library(HarmonyLinkLibStatic STATIC ${LIB_SOURCES} ${LIB_INCLUDES}) @@ -171,25 +180,54 @@ target_include_directories(HarmonyLinkLibStatic "${PROJECT_SOURCE_DIR}/include" ) target_compile_definitions(HarmonyLinkLibStatic PRIVATE HARMONYLINKLIB_STATIC) +set_target_properties(HarmonyLinkLibStatic PROPERTIES OUTPUT_NAME "HarmonyLinkLibStatic_${COMPILER_NAME}") # Set output directories for all build types -foreach(TYPE IN ITEMS DEBUG RELEASE) - string(TOUPPER ${TYPE} TYPE_UPPER) - set_target_properties(HarmonyLinkLibShared PROPERTIES - RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/HarmonyLinkLib" - LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/HarmonyLinkLib" - ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLib" - ) - set_target_properties(HarmonyLinkLibStatic PROPERTIES - ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLibStatic" - ) -endforeach() +#foreach(TYPE IN ITEMS DEBUG RELEASE) +# string(TOUPPER ${TYPE} TYPE_UPPER) +# set_target_properties(HarmonyLinkLibShared PROPERTIES +# RUNTIME_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/bin/${TYPE}/HarmonyLinkLib" +# LIBRARY_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/lib/${TYPE}/HarmonyLinkLib" +# ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLib" +# ) +# set_target_properties(HarmonyLinkLibStatic PROPERTIES +# ARCHIVE_OUTPUT_DIRECTORY_${TYPE_UPPER} "${CMAKE_BINARY_DIR}/archive/${TYPE}/HarmonyLinkLibStatic" +# ) +#endforeach() # Link fmt to HarmonyLinkLib target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt-header-only) target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt-header-only) -if (UNIX) +# Determine the compiler and set appropriate flags for libc++ +if (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "Clang") + # Use libc++ instead of libstdc++ with Clang + target_compile_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) + target_compile_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) + target_link_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) + target_link_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) + + # Ensure the proper include paths for libc++ + target_include_directories(HarmonyLinkLibStatic SYSTEM PRIVATE + /usr/include/c++/v1 + /usr/local/include/c++/v1 + /usr/include + ) + target_include_directories(HarmonyLinkLibShared SYSTEM PRIVATE + /usr/include/c++/v1 + /usr/local/include/c++/v1 + /usr/include + ) + + # Link against the libc++ library and the filesystem library + target_link_libraries(HarmonyLinkLibStatic PRIVATE c++ c++abi c++experimental) + target_link_libraries(HarmonyLinkLibShared PRIVATE c++ c++abi c++experimental) +elseif (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "GNU") + # Use libstdc++ with GCC + target_link_options(HarmonyLinkLibStatic PRIVATE -static-libgcc -static-libstdc++) + target_link_options(HarmonyLinkLibShared PRIVATE -static-libgcc -static-libstdc++) + + # Link against the libstdc++ filesystem library if necessary target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) endif() From 7f0fa0b90d7464378b6d0941cab930e60b2e9b3c Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 6 Jun 2024 16:04:34 +0100 Subject: [PATCH 51/54] Improved Compile.sh --- Compile.sh | 134 +++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 94 insertions(+), 40 deletions(-) diff --git a/Compile.sh b/Compile.sh index c8d82ea..63ea1c3 100644 --- a/Compile.sh +++ b/Compile.sh @@ -1,49 +1,96 @@ -#!/bin/sh +#!/bin/bash set -e clear -# Define the color codes +# Define color codes GREEN='\033[0;32m' NC='\033[0m' # No Color +PURPLE='\033[0;35m' +GRAY='\033[1;30m' -# Prompt the user to choose a compiler -echo "${GREEN}Select the compiler to use:${NC}" -echo "1) g++ (default)" -echo "2) clang++" -echo "3) clang++ 15" -echo "4) clang++ 16" -read -p "Enter the number of your choice: " choice +# Ensure dialog is installed +if ! command -v dialog &> /dev/null +then + echo "dialog could not be found. Please install it to use this script." + exit +fi -# Set the compiler based on the user's choice -case $choice in - 2) - C_COMPILER=clang - CXX_COMPILER=clang++ - ;; - 3) - C_COMPILER=clang-15 - CXX_COMPILER=clang++-15 - ;; - 4) - C_COMPILER=clang-16 - CXX_COMPILER=clang++-16 - ;; - *) - C_COMPILER=gcc - CXX_COMPILER=g++ - ;; -esac +# Function to check if a compiler is installed +check_compiler() { + if command -v $1 &> /dev/null + then + COMPILER_OPTIONS+=("$2" "$3" "$4") + fi +} -echo "Using C compiler: $C_COMPILER" -echo "Using C++ compiler: $CXX_COMPILER" +# Array to store the menu options +COMPILER_OPTIONS=() + +# Add available compilers to the options array +check_compiler g++ "1" "g++ (default)" "on" +check_compiler clang++ "2" "clang++" "off" +check_compiler clang++-15 "3" "clang++ 15" "off" +check_compiler clang++-16 "4" "clang++ 16" "off" +check_compiler clang++-17 "5" "clang++ 17" "off" + +# Debug: print the compiler options +echo "Compiler options: ${COMPILER_OPTIONS[@]}" + +# Check if any compilers are available +if [ ${#COMPILER_OPTIONS[@]} -eq 0 ]; then + dialog --msgbox "No compilers found. Please install a compiler to use this script." 10 40 + exit +fi + +# Prompt the user to choose one or more compilers +compiler_choices=$(dialog --colors --title "\Zb\Z5Select Compiler\Zn" --checklist "\nChoose one or more compilers:" 15 60 ${#COMPILER_OPTIONS[@]} "${COMPILER_OPTIONS[@]}" 3>&1 1>&2 2>&3) + +# Process the selected compilers +C_COMPILERS=() +CXX_COMPILERS=() + +# Debug: print the compiler choices +echo "Compiler choices: $compiler_choices" + +for choice in $compiler_choices; do + case $choice in + 1) + C_COMPILERS+=("gcc") + CXX_COMPILERS+=("g++") + ;; + 2) + C_COMPILERS+=("clang") + CXX_COMPILERS+=("clang++") + ;; + 3) + C_COMPILERS+=("clang-15") + CXX_COMPILERS+=("clang++-15") + ;; + 4) + C_COMPILERS+=("clang-16") + CXX_COMPILERS+=("clang++-16") + ;; + 5) + C_COMPILERS+=("clang-17") + CXX_COMPILERS+=("clang++-17") + ;; + esac +done + +# Output the chosen compilers +msg="Chosen compilers:\n" +for i in "${!C_COMPILERS[@]}"; do + msg+="C compiler: ${C_COMPILERS[$i]}, C++ compiler: ${CXX_COMPILERS[$i]}\n" +done + +dialog --colors --msgbox "\Zb\Z5$msg\Zn" 20 60 # Prompt the user to choose a build type -echo "${GREEN}Select the build type:${NC}" -echo "1) Release (default)" -echo "2) Debug" -read -p "Enter the number of your choice: " build_choice +build_choice=$(dialog --colors --title "\Zb\Z5Select Build Type\Zn" --menu "\nChoose a build type:" 10 40 2 \ +1 "Release (default)" \ +2 "Debug" 3>&1 1>&2 2>&3) # Set the build type based on the user's choice case $build_choice in @@ -55,7 +102,10 @@ case $build_choice in ;; esac -echo "Build type: $BUILD_TYPE" +# Output the chosen build type +dialog --colors --msgbox "\Zb\Z5Build type:\Zn $BUILD_TYPE" 10 40 + +clear # Create the build directory if it doesn't exist if [ ! -d "linuxbuild" ]; then @@ -64,10 +114,14 @@ fi cd linuxbuild -# Run CMake with the selected compiler and build type -cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_C_COMPILER=$C_COMPILER -DCMAKE_CXX_COMPILER=$CXX_COMPILER .. - -# Build the project -cmake --build . --config $BUILD_TYPE --clean-first -j 15 --verbose +# Run CMake with the selected compilers and build type +for i in "${!C_COMPILERS[@]}"; do + cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_C_COMPILER=${C_COMPILERS[$i]} -DCMAKE_CXX_COMPILER=${CXX_COMPILERS[$i]} .. + # Build the project + cmake --build . --config $BUILD_TYPE -j 15 #--clean-first #--verbose +done cd .. + +# End with a success message +dialog --colors --msgbox "\Zb\Z5Build(s) completed successfully!\Zn" 10 40 From a7a80571ea304f1fa9baeb89f5a17194593b9853 Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 6 Jun 2024 19:20:29 +0100 Subject: [PATCH 52/54] Remove stdc++fs requirement by using an external library --- .gitattributes | 5 +- HarmonyLinkLib/CMakeLists.txt | 78 +++++++++++-------- HarmonyLinkLib/src/Platform/WineUtilities.cpp | 6 +- 3 files changed, 55 insertions(+), 34 deletions(-) diff --git a/.gitattributes b/.gitattributes index 970e13f..92bbb8f 100644 --- a/.gitattributes +++ b/.gitattributes @@ -36,4 +36,7 @@ # Executables *.exe binary *.out binary -*.app binary \ No newline at end of file +*.app binary + +# Linux shell files must always be LF +*.sh text eol=lf \ No newline at end of file diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 2e2ed12..311eed3 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -28,6 +28,18 @@ FetchContent_MakeAvailable(fmt) set_target_properties(fmt PROPERTIES FOLDER External) set_target_properties(fmt PROPERTIES POSITION_INDEPENDENT_CODE TRUE) +# Fetch ghc library +FetchContent_Declare( + ghc_filesystem + GIT_REPOSITORY https://github.com/gulrak/filesystem.git + GIT_TAG v1.5.14 # Specify the desired version of ghc +) + +FetchContent_MakeAvailable(ghc_filesystem) + +set_target_properties(ghc_filesystem PROPERTIES FOLDER External) +set_target_properties(ghc_filesystem PROPERTIES POSITION_INDEPENDENT_CODE TRUE) + # Find the current Git branch and the last commit timestamp find_package(Git QUIET) if(GIT_FOUND) @@ -199,35 +211,39 @@ set_target_properties(HarmonyLinkLibStatic PROPERTIES OUTPUT_NAME "HarmonyLinkLi target_link_libraries(HarmonyLinkLibStatic PRIVATE fmt::fmt-header-only) target_link_libraries(HarmonyLinkLibShared PRIVATE fmt::fmt-header-only) +# Link ghc to HarmonyLinkLib +target_link_libraries(HarmonyLinkLibStatic PRIVATE ghc_filesystem) +target_link_libraries(HarmonyLinkLibShared PRIVATE ghc_filesystem) + # Determine the compiler and set appropriate flags for libc++ -if (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "Clang") - # Use libc++ instead of libstdc++ with Clang - target_compile_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) - target_compile_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) - target_link_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) - target_link_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) - - # Ensure the proper include paths for libc++ - target_include_directories(HarmonyLinkLibStatic SYSTEM PRIVATE - /usr/include/c++/v1 - /usr/local/include/c++/v1 - /usr/include - ) - target_include_directories(HarmonyLinkLibShared SYSTEM PRIVATE - /usr/include/c++/v1 - /usr/local/include/c++/v1 - /usr/include - ) - - # Link against the libc++ library and the filesystem library - target_link_libraries(HarmonyLinkLibStatic PRIVATE c++ c++abi c++experimental) - target_link_libraries(HarmonyLinkLibShared PRIVATE c++ c++abi c++experimental) -elseif (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "GNU") - # Use libstdc++ with GCC - target_link_options(HarmonyLinkLibStatic PRIVATE -static-libgcc -static-libstdc++) - target_link_options(HarmonyLinkLibShared PRIVATE -static-libgcc -static-libstdc++) - - # Link against the libstdc++ filesystem library if necessary - target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) - target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) -endif() +#if (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "Clang") +# # Use libc++ instead of libstdc++ with Clang +# target_compile_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) +# target_compile_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) +# target_link_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) +# target_link_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) +# +# # Ensure the proper include paths for libc++ +# target_include_directories(HarmonyLinkLibStatic SYSTEM PRIVATE +# /usr/include/c++/v1 +# /usr/local/include/c++/v1 +# /usr/include +# ) +# target_include_directories(HarmonyLinkLibShared SYSTEM PRIVATE +# /usr/include/c++/v1 +# /usr/local/include/c++/v1 +# /usr/include +# ) +# +# # Link against the libc++ library and the filesystem library +# target_link_libraries(HarmonyLinkLibStatic PRIVATE c++ c++abi c++experimental) +# target_link_libraries(HarmonyLinkLibShared PRIVATE c++ c++abi c++experimental) +#elseif (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "GNU") +# # Use libstdc++ with GCC +# target_link_options(HarmonyLinkLibStatic PRIVATE -static-libgcc -static-libstdc++) +# target_link_options(HarmonyLinkLibShared PRIVATE -static-libgcc -static-libstdc++) +# +# # Link against the libstdc++ filesystem library if necessary +# target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) +# target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) +#endif() diff --git a/HarmonyLinkLib/src/Platform/WineUtilities.cpp b/HarmonyLinkLib/src/Platform/WineUtilities.cpp index efe48a3..fca7352 100644 --- a/HarmonyLinkLib/src/Platform/WineUtilities.cpp +++ b/HarmonyLinkLib/src/Platform/WineUtilities.cpp @@ -18,12 +18,14 @@ #include #include #include -#include +#include #ifdef BUILD_WINDOWS #include #endif +namespace fs = ghc::filesystem; + namespace HarmonyLinkLib { bool force_detect_wine = false; @@ -38,7 +40,7 @@ namespace HarmonyLinkLib FBattery result = {}; for (int i = 0; i <= 9; ++i) { - if (std::string bat_path = append + "/sys/class/power_supply/BAT" + std::to_string(i); std::filesystem::exists(bat_path)) { + if (std::string bat_path = append + "/sys/class/power_supply/BAT" + std::to_string(i); fs::exists(bat_path)) { result.has_battery = true; std::ifstream status_file(bat_path + "/status"); From 416fdb3bdbd5addd6880e62e06daa9fa046c0b0e Mon Sep 17 00:00:00 2001 From: Jordon Brooks Date: Thu, 6 Jun 2024 20:06:09 +0100 Subject: [PATCH 53/54] UE4 Linux successful compile --- HarmonyLinkLib/CMakeLists.txt | 50 +++++++++++++---------------------- 1 file changed, 19 insertions(+), 31 deletions(-) diff --git a/HarmonyLinkLib/CMakeLists.txt b/HarmonyLinkLib/CMakeLists.txt index 311eed3..de087b6 100644 --- a/HarmonyLinkLib/CMakeLists.txt +++ b/HarmonyLinkLib/CMakeLists.txt @@ -216,34 +216,22 @@ target_link_libraries(HarmonyLinkLibStatic PRIVATE ghc_filesystem) target_link_libraries(HarmonyLinkLibShared PRIVATE ghc_filesystem) # Determine the compiler and set appropriate flags for libc++ -#if (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "Clang") -# # Use libc++ instead of libstdc++ with Clang -# target_compile_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) -# target_compile_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) -# target_link_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) -# target_link_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) -# -# # Ensure the proper include paths for libc++ -# target_include_directories(HarmonyLinkLibStatic SYSTEM PRIVATE -# /usr/include/c++/v1 -# /usr/local/include/c++/v1 -# /usr/include -# ) -# target_include_directories(HarmonyLinkLibShared SYSTEM PRIVATE -# /usr/include/c++/v1 -# /usr/local/include/c++/v1 -# /usr/include -# ) -# -# # Link against the libc++ library and the filesystem library -# target_link_libraries(HarmonyLinkLibStatic PRIVATE c++ c++abi c++experimental) -# target_link_libraries(HarmonyLinkLibShared PRIVATE c++ c++abi c++experimental) -#elseif (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "GNU") -# # Use libstdc++ with GCC -# target_link_options(HarmonyLinkLibStatic PRIVATE -static-libgcc -static-libstdc++) -# target_link_options(HarmonyLinkLibShared PRIVATE -static-libgcc -static-libstdc++) -# -# # Link against the libstdc++ filesystem library if necessary -# target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) -# target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) -#endif() +if (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "Clang") + # Use libc++ instead of libstdc++ with Clang + target_compile_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) + target_compile_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) + target_link_options(HarmonyLinkLibStatic PRIVATE -stdlib=libc++) + target_link_options(HarmonyLinkLibShared PRIVATE -stdlib=libc++) + + # Link against the libc++ library and the filesystem library + target_link_libraries(HarmonyLinkLibStatic PRIVATE c++ c++abi c++experimental) + target_link_libraries(HarmonyLinkLibShared PRIVATE c++ c++abi c++experimental) +elseif (UNIX AND CMAKE_CXX_COMPILER_ID MATCHES "GNU") + # Use libstdc++ with GCC + target_link_options(HarmonyLinkLibStatic PRIVATE -static-libgcc -static-libstdc++) + target_link_options(HarmonyLinkLibShared PRIVATE -static-libgcc -static-libstdc++) + + # Link against the libstdc++ filesystem library if necessary + #target_link_libraries(HarmonyLinkLibStatic PRIVATE stdc++fs) + #target_link_libraries(HarmonyLinkLibShared PRIVATE stdc++fs) +endif() From cb84f3dff845286163f73d6baf566fd128076b59 Mon Sep 17 00:00:00 2001 From: jordon Date: Sun, 4 May 2025 14:28:55 +0100 Subject: [PATCH 54/54] Updated links --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 81a55f2..f8a5b5e 100644 --- a/README.md +++ b/README.md @@ -61,22 +61,22 @@ As you can see, Even though it's running on Proton, we can still detect the unde Integrate HarmonyLink 2.0 into your game project with ease: -1. Download the latest version of HarmonyLink 2.0 from the [releases page](https://github.com/Jordonbc/HarmonyLink/releases/latest). +1. Download the latest version of HarmonyLink 2.0 from the [releases page](https://git.bbgames.dev/jordon/HarmonyLink/releases/latest). 2. Add the HarmonyLink DLL to your project according to your development environment's specifications. 3. Utilize the provided API to access device-specific metrics and enhance your game's performance on handheld devices. -Refer to the [integration documentation](https://github.com/Jordonbc/HarmonyLink/wiki/Integration-Guide) for detailed instructions. +Refer to the [integration documentation](https://git.bbgames.dev/jordon/HarmonyLink/wiki) for detailed instructions. ### Unreal Engine 5 Plugin For developers leveraging Unreal Engine 5.3 or newer*, HarmonyLink 2.0 is readily accessible as a plugin: -1. Clone or download the HarmonyLink UE5 Plugin from the [Unreal Engine Plugin repository](https://github.com/Jordonbc/HarmonyLinkUE). +1. Clone or download the HarmonyLink UE5 Plugin from the [Unreal Engine Plugin repository](https://git.bbgames.dev/jordon/HarmonyLinkUE). 2. Place the HarmonyLink plugin folder into the `Plugins` directory of your Unreal Engine 5 project. 3. Enable the HarmonyLink plugin from the Edit > Plugins menu within Unreal Engine 5. 4. Access HarmonyLink functionalities via Blueprints or C++ within your project. -For a step-by-step guide, visit the [Unreal Engine 5 Plugin instructions](https://github.com/Jordonbc/HarmonyLinkUE/wiki/Integration-Guide) on our wiki. +For a step-by-step guide, visit the [Unreal Engine 5 Plugin instructions](https://git.bbgames.dev/jordon/HarmonyLinkUE/wiki) on our wiki. *With potential backward compatibility, not verified. @@ -91,7 +91,7 @@ If you prefer to build HarmonyLink 2.0 from the source code, follow these steps: 5. Compile the code by running `cmake --build build --config Release`. 6. The built DLL will be located in the `build/bin/HarmonyLinkLib` directory. -For additional building options and troubleshooting, refer to the [building from source documentation](https://github.com/Jordonbc/HarmonyLink/wiki/Building-From-Source). +For additional building options and troubleshooting, refer to the [building from source documentation](https://git.bbgames.dev/jordon/HarmonyLink/wiki). ## How It Works

    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